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PREFACE 



Data General s Stand-alone Operating System (SOS) performs I/O for programs that 
operate in a non-disk environment. This environment may consist only of paper 
tape or may also include cassettes and/or magnetic tape. Included in the SOS 
l^r *? ^J 0110 ^ utilit y P«>grams: Relocatable Loader, Extended Assembler, 
Symbolic Text Editor, SYSGEN. and Library File Editor. Systems with cassette or 
magnetic tape are supplied with a Command Line Interpreter (CLI) and a Core Image 
Leader/Writer. Optionally, a FORTRAN IV compiler is supplied with the system. 

The user communicates with SOS through system command words built into his 
assembly language program and through the utility programs. For cassette or 
magnetic tape systems, the CLI utility may be used to perform file maintenance 
functions as well as to invoke other system utilities or user programs. 

The current version of SOS has a number of new capabilities: 

1. Support of a Real Time Clock. 

• The driver allows selection of 10Hz, 100Hz, 1000Hz, 60Hz, or 50Hz 
line frequency,. 

• The clock may be accessed via system commands to set the time of 
day, get the time of day, set the date, get the date, get the current 
clock frequency, or suspend a program for a given period. 

• The clock may be accessed via CLI commands to set the time of day, 
set the date, or get both time of day and date. 

2. Line Printer support with optional (80 or 132) column size. 

3. Support of a second teletypewriter keyboard and teletypewriter printer. 

4. New User Device Driver Links 

• System commands that identify a user interrupt device and remove it 
from the system. 

• Five external normals are declared in the SOS MAIN program and may 
optionally be resolved by the user as starting addresses of user DCT f s 
Two of the devices will occupy the highest SOS priorities in the interrupt 
search chain and the other three will occupy the lowest SOS priority 
(The user may, of course, still elect to write his own code that will 
place devices at different priority levels. ) 



4. (Continued) 

• SOS file/device names and SOS Channel Numbers are available for 
these user added device handlers, 

5. The CL1 has been substantially modified and many new features added 
in this version of SOS, 
Initializing and releasing magnetic tapes or cassettes. 

Copying files or tape reels and transferring files from one device/file 

to another. 

Producing dump format files and reloading dumped files. 

Making files in absolute or save file formats. 

Concatenating files. 

Comparing files. 

Starting programs hi the SOS Debugger. 

Setting or getting the current date and time. 

The CLI BOOT command can be used to invoke either a system utility 

or a user file. 

6. A number of less extensive changes were made in SOS or utilities under 
SOS to correct problems or to improve the system: 

. System commands . EOPEiN and . ROPEN, were added for RDOS compat- 
ibility but are treated as identical to . OPEN. 

• The .SYSI initialization function is performed for the user if he starts 

his program at 377, 

• When a CTRL A or CTRL C character is detected from the $TTI and 

the corresponding UST enable /disable location is disabled, the character 
is ignored instead of being passed on to the user program. 

• The RDOS to SOS interface program is now named RDS1. 

. The Relocatable Loader resolves all undefined external jy^lsto -l, 
compatible with the RDOS loader. Also, the insertion of a JMP @405 is 

is no longer made at location 377. 

ii 



6. (Continued) 

• The Core Image Loader /Writer may be installed directly on any 
magnetic tape or cassette reel, without first "MKSAVing" the file. It 
now starts or halts programs that it has loaded based on the TTY console 
command rather than the setting of DATA SWITCH ZERO on the Nova 
master console, 

• In configuring a master reel of utilities, the configured Relocatable 
Loader now occupies File 1 and can then be used in the remainder of 
the configuring procedures. 



ill 
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CHAPTER 1 
INTRODUCTION TO SOS 



S SC^H^P ^ g yStem (S ° S) PaCkage COnsists of the SOS Libraries and 

for fif ^ ^"ns. The SOS Libraries contain routines which pfrform im 

for all programs that execute in a non-disk environment Th" T/n Per T m l/ ? 
on an interrupt driven basis, uslng core bmfer™^ eS.^^ffif 

The SOS Utilities provide all the develonmpnt- f a HHri Q „ 

INTRODUCTORY CONCEPTS 

The SOS Libraries are the following: 

The SOS C assette Tape Library (099-000041) 

This library contains device driver routines which support from 1 to 8 
cassette tape units; it is supplied to all users having cassettes 

The SOS Magn etic Tape Library itlQQ-onnrM/n 

This library contains device driver routines which support from 1 to 8 
-gnetxc tape transports; it is supplied to all users having m^fo tape 

The SOS Library (099-000010) 

for S alH/0 I Ievic SUPPlied * ^ ^ ^^ ft C ° ntalnS devlce d "^ routines 
for all I/O devices except cassette and magnetic tape. It also contains the 

mam con ro program, several user application routines, and the RDOS 
compare" ^^ ""^ ^ S ° S pr ° gram faterface RD °S- 

Tne arrangement of these programs as library files is convenient for SOS users- 
all destred routmes may be selected from me libraries at (relocatable) foad time 
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INTRODUCTORY CONCEPTS : (Continued) 

and incorporated into toe load module. All ^e***™^?^.^ ?£?" 
are excluded from toe load module. However, only three or less library files 
Teed to be passed torough toe Relocatable Loader rather ^^^^^ 
relocatable binary files. The user must, of course, provide a .external Reference 
in a previously "loaded" program to cause toe selection of any des ^^ ra ^ 
oroerams for "loading" (see The Relocatable Loaders Manual, 093-000080, Loading 

L Tr^ Tapes). L ordering of the programs within these ^^^' 
feat the necessary external references are kept to a minimum. (See Chapter 2, 
Loading SOS Routines and Device Drivers. ) 

RDOS TO SOS INTERFACE PROGRAM 

The RDOS to SOS Interface (RDSI) program makes SOS fully RDOS compare. 
Tne primary difference between toe two versions of SOS (with and without RDSI) is 
the following: - 

RDOS Channel Numbers from 0-76 8 are available. 

Programs that rtmpvddtoout RDSI open files and devices on a physical StOfSjChaa^el 
Ncutaber. Further Ice^ses to the file are made on toe same SOS Channel Number . 
fetcTs Channel Numbers range from 0-37 8 . * Table 2-1 lists the , SOS 
file/ device names and their associated channel numbers. (See also Appendix A. , 

f cn<! ,-<= sptorted from the SOS Library' by declaring . RDSI as 
rExSIi! NORMAL . kS^5T«£ latter version is selected by declaring 

SOS as T^SJl NORMAL./ee Table 2-2, External Normal Symbols for 
Optional SOS Routines). 

T^e onlv system commands that differ depending on the version of SOS being used 
T.JmjZ GCHN . See Chapter 4, Program Mode of Communication, for a 
description of all System Commands. 

Because of the occasional need to distinguish between these versions of SOS, the 
terminology below will be adopted for the remainder of this manual. 

RDOS - SOS shall refer to SOS configurations in which the RDSI program 
is present. 



^However, 0-4 are unassigned; they are available for adding user device handlers. 

See Appendix A. 
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RDOS TO SOS I NTERFACE PROGRAM (Continued) 

fsltl 505 - 511 " 11 refer t0 S ° S COnfi ^ ratlons fa **** ^ RDSI program 

Whenever the term SO^is used without one of the modifiers above, eifter SOS 
configuration is implied. * S2S bUh 

COMMUNICATING WITH SOS 

TsZZTz p z^i:rj;: it to faterface wi * sos and * — •* 

• via programmed system calls 

• through the console Command Line Interpreter commands 

(CWy available for SOS configurations which include cassette or magnetic 

• through the SOS Utility programs 

System calls are issued as program instructions; they activate logic within the 
re c™e7 b ^S ta *•**"*»*»■ — 4 bribes eac^ call 

The Command Line Interpreter (CLI) is a system program that accepts command 

con oTe'an^ tat T^r ^ CU aCtS 3S "" taterfaCe tetween * e user at fce 
^h,°J ° U,pUtS a ready messa « e P rom Pt- "R" when it is first 

2l ctVl * e d sr?fc!r^ t reserved key combtaa - 

, m .„• . x Kij and u ^e CLI may also be used to load the SOS 

utdmes tnto core via dae "BOOT" command. Chapter 3 describes die CLI h 

otttin! ^sH^^ ** ** '***"* ^^ ** USer at «* c °™°^ ** *e 
operating system. These programs are more specific in purpose than the CLI 

S le^ta^r/f o e m S r ; "V* ^^ ^^ <** abSOlute ° "etcat- 
awe bmary fdes from assembler source fUes; and the SOS FORTRAN IV Comniler 

produces only assembler source files from FORTRAN source files. L ° mpiler 
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COMMUNICATING WITH SOS (Continued) 

All SOS users receive five SOS Utilities: 

SOS Text Editor 

SOS Extended Assembler 

SOS Library File Editor 

SOS SYSGEN Program 

SOS FORTRAN IV Compiler (requires 16K of core minimum) 

SOS Users having either cassette or magnetic tape drives receive three additional 
programs: 

SOS Relocatable Loader* 

SOS Command Line Interpreter 

Core Image Loader/Writer 
The operation of each SOS Utility is described in Chapter 3. The SOS Library and 
Utility tapes supplied for each system are listed in Chapter 5. 

GENERATING SOS SYSTEMS 

Because of the many combinations of devices at user ^^.fte £**L 
tailor utility programs to the hardware configuration is provided with the P«e. 
^piSto^produce a tailored system generally consists of performmg a 
relocatable load on: 

(1) the appropriate "trigger" relocatable binaries (.RBs) ; 

(2) the SOS Libraries and, 

(3) the respective utility .RBs. 

The outout from this procedure is a core image of the tailored SOS Utility; this 
ZJeTnTenbt saved as either a save file on cassette or magnetic tape or as an 
3ute ohtary fUe on paper tape. ThTsave file may *^££f£2£Z 
into core by me Core image *%%£^S^^^ 
the Absolute Binary Loader. "The trigger tile, vmicn cause cysGEN 

desired routines from the SOS Libraries, may be produced by the SOS SYSGEN 
program Relocatable binaries of each of the SOS Utilities are supplied m order 
forme user to perform these procedures. Preconfigured utilities are also 
»SOS users w ithout cassette or magnetic tape dr^ are supplied the Stand- Alone 
Extended Relocatable Loader, Absolute Binary: 091-000038; see Chapter 5. 
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GENERATING SOS SYSTEMS (. Continued) 

supplied for systems with standard configurations; these programs are provided 
in either absolute binary or save file format. Chapter 5 gives detailed instructions 
for configuring SOS Utilities in magnetic tape, cassette tape, or paper tape 
environments. 

SOS ORGANIZATION 

All I/O drivers, control routines, tables, etc. , included in the SOS Libraries are 
relocatable . They may occupy any block of core above location 440g; this Is the 
first location into which any of the DGC Relocatable Loaders deposit normall y 
relocatable (.NREL) data. Locations 0-17g in page zero are appropriated oy the 
main control program in the SOS Library. Location 377g in page zero contains a 
"JMP" @2" instruction; whenever a program is started at location 377, a full 
initialization of SOS (equivalent to system command ". SYSI") is performed and 
control is then passed to the starting address specified in the user or utility 
program. 

This address resides in the User Status Table or UST. Each user program has an 
associated UST. This table is set up by the Relocatable Loader; it contains inform- 
ation such as starting address, start and end of symbol table, highest address 
used, etc. It begins allocation 400g. See Chapter 4, User Status Table. 

The highest 400g locations in memory are normally occupied by either the Core 
Image Loader/Writer or the Absolute Binary Loader. For this reason, the SOS 
memory commands (see Chapter 4 , .MEM and . ME MI) recognize the highest 
physical memory location -400g as the highest memory available (HMA) to the user. 

The memory that is available for user or utility programs and data is then 
essentially the following: 

• All page zero locations (inclusive) between 20g and 37 6g. 

• All other memory between 440g and the last memory address -400g, except 
that which is necessary for the selected combination of SOS routines, tables, 
and buffers. 

Figure 1-1 gives a sample representation of all core after a user module has been 
loaded with SOS Libraries. For illustrative purposes, the module is assumed to 
be comprised of two user programs, USR1 and USR2, both of which contain normally 
and page zero relocatable data. 
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400g Locations 



ABSOLUTE 

BINARY OR CORE IMAGE 

LOADER 



Highest Physical 
Memory Address 

. HMA, highest memory 
address available to 



^r 



USR2 .NR EL DATA 



SOS - 

DEVICE DRIVERS, CONTROL 

ROUTINES, I/O BUFFERS, 
AND TABLES 



USR1 .NRELDATA 



440 



.400 
377 



IMP @2 



Page 
Zero 



USR2 . ZREL DATA 



50 

20 





USR1 .ZREL DATA 



SOS PAGE ZERO 



NMAX (first location 
available above 
loaded programs) 



Start of all .NREL data 



UST 



Bottom of Memory 



Figure 1-1. Loaded Program in Core 
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CHAPTER 2 

SOS FILES AND DEVICES 

SOS files may reside on any SOS device; these devices include magnetic tape units, 
high speed paper tape reader, high speed paper tape punch, teletype keyboard, etc. 
In this sense, the terms file and device are interchangeable in the SOS environment. 
Files are "read from" and "written to"; devices are also "read from" and "written 
to 17 ! In the case of magnetic and cassette tapes however, the term file is slightly 
more encompassing: 

The tape unit or device may contain several files. For example, 
cassette unit 1 may contain the files CT1:0, CT1:1, CT1:2 and CT1:3. 

Cassette and magnetic tape units are the only devices upon which more than one 
file may reside at the same time. The expression file/device which occurs 
throughout the remainder of this manual denotes this distinction, 

SPECIFYING SOS DEVICES 

In a Standard SOS environment, a device is "opened" by passing its fixed SOS 
Channel Number to the operating system. Under RDOS -SOS, a device is "opened" 
by passing its filename and an RDOS Channel Number (0-7 6g) to the operating 
system; the system then translates that name into the appropriate SOS Channel 
Number in order to complete the "open". The RDOS Channel Number that is 
passed is only assigned to that device for the duration of the "open". The SOS 
Channel Numbers are always assigned to the same devices however. The list 
of SOS devices by name and by SOS Channel Number is shown in Table 2-1. 



Device Name 


Fixed Channel No. 

5 


Device Name Fi 


xed Channel 


No. 


TTI1 


MT3 


23 




$PLT 


6 


MT4 


24 




TTOl 


7 


MT5 


25 




$TTP 


10 


MT6 


26 




$CDR 


11 


MT7 


27 




$TTO 


12 


CTO 


30 




$TTI 


13 


CT1 


31 




$LPT 


14 


CT2 


32 




$PTR 


15 


CT3 


33 




$PTP 


16 


CT4 


34 




$TTR 


17 


CT5 


35 




MTO 


20 


CT6 


36 




MT1 


21 


CT7 


37 




MT2 


22 









Table 2-1. SOS Devices 
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SPECIFYING SOS DEVICES (Continued) 

The device names are the same as those recognized by RDOS. TTIi and TTOi refer 
to a second teletype which uses device codes 50g and 51 8 , The other names are 
self-explanatory. All SOS Utilities recognize devices by the names shown in this 
table, 

LOADING SOS ROUTINES AND DEVICE DRIVERS 

In order to select any program in the SOS Libraries for loading, an ENTRY symbol 
(. ENT) in the desired program must resolve an EXTERNAL (. EXTN or . EXTD) 
symbol declared in a previously loaded program. It is the user's responsibility to 
supply these EXTERNAL declarations to the Relocatable Loader before the SOS 
Libraries are provided as input to the loader. Each separately assembled program 
in the SOS Libraries has one or more ENTRY symbols associated with it. Many of 
these programs also have EXTERNAL declarations which select successive library 
programs for loading, once they themselves are loaded. For example, the SOS 
Magnetic Tape Library contains 8 separate programs: a control table and I/O 
buffer for units 1-7 plus a control table, I/O buffer and device driver (which controls 
from 1-8 units) for unit 0. In order to load the necessary programs to support 8 
units, only one EXTERNAL declaration need be specified however. That program 
will then cause the loading of each subsequent program in the library. 

The complete set of necessary EXTERNAL declarations in relocatable binary format 
is called a trigger . Triggers are produced in two ways: 

(1) By assembling a source program of the form: 

. TITLE TRIGGER 
.EXTN A,B,C,... 

.END 

where A,B,C,. . . are the symbols that are ENTRY points in the desired 
routines in the SOS Libraries. 

(2) By using the SYSGEN program to produce the relocatable binary file 
directly. In the above example, the SYSGEN command line shown below 
would produce an equivalent file on the high speed punch. 

(SYSG) TRIGG /T $PTP/0 ABC.,.,) 

Table 2-2 lists the necessary EXTERNAL NORMAL declarations in order to select 
any SOS Library program for loading. 

Programmers using SOS or Stand-alone RLDR must use . EXTN. 
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CASSETTE SOS LIBRARY* 099-000041 


External 


Program 




Normal 


Name 


Purpose 


.CTU7 


CTU7 


control fable/core buffer to support cassette units 0-7. 


, CTU6 


CTU6 


control table /core buffer to support cassette units 0-6. 


,CTU1 


CTU1 


control table/core buffer to support cassette units & 1. 


.CTAD 


CTADR 


cassette driver \v /control table/core buffer for unit 0, 



MAGNETIC TAPE SOS LIBRARY* 099-000042 


External 
Normal 


Program 
Name 


Purpose 


. MTU7 

.MTU6 


MTU7 
MTU6 


control table /core buffer to support mag tape units 0-7. 
control table/core buffer to support mag tape units 0-6. 


.MTUI 
.MTAD 


MTUI 
MTADR 


control table/core buffer to support mag tape units & 1. 
magnetic tape drive w/control table/core buffer for unit 0. 



SOS LIBRARY 



099-000010 



External 
Normal 

.CTB 
. SAVR 

.RDSI 
.PLTD 

• CDRD 
.PTRD 

. PTPD 
.LPTD 
.L132 

• STTY 
.TTI1 
.RTC5 
.RTC4 
.RTC3 
.RTC2 
.RTC1 
.SOS 



Program 
Name 

CTB 
SAVRE 

RDSI 
PLTDR 
CDRDR 
PTRDR 

PTPDR 

LPTDR 

LP132 

STTYDR 

TTYi 

RTCT5 

RTCT4 

RTCT3 

RTCT2 

RTCT1 

SOS 



Purpose 

command table builder for SOS application programs 

save/restore routine for SOS user application programs 

RDOS to SOS interface program (Will cause loading of . SOS) 

plotter driver (will cause loading of . SOS) 

card reader driver (will cause loading of . SOS) 

paper tape reader driver (will cause loading of .SOS) 

paper tape punch driver (will cause loading of . SOS) 

80 column line printer driver (will cause loading of . SOS) 

132 column line printer driver (will cause loading of .SOS) 

small teletype driver ($TT1,$TT0 only) (will cause loading of .SOS) 

second $TTI and $TT0 driver (will cause loading of . SOS) 

50 Hz (line frequency) real time clock driver (will cause loading of . SOS) 

60 Hz (line frequency) real time clock driver (will cause loading of . SOS) 

1000 Hz real time clock driver (will cause loading of . SOS) 

100 Hz real time clock driver (will cause loading of .SOS) 

10 Hz real time clock driver (will cause loading of .SOS) 

main program of SOS 



*When performing relocatable loads with the SOS Libraries, the Magnetic Tape and Cassette Libraries 
must always precede the SOS Library as input to the loader. 



Table 2-2. External Normal Symbols for Optional SOS Routines 
and Device Drivers 
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CASSETTE AND MAGNETIC TAPE FILES 

A single magnetic tape or cassette unit may contain up to 100 files, which 
are designated through 99, Both the unit number and the file number must 

be specified in order to open these files. 

Physical Characteristics of Cassette and Magnetic Tapes 

Up to eight cassette drives and eight magnetic tape drives are permitted per system. 
Magnetic tape drives must be 9 -track. 

NOTE: No magnetic tape file may be written unless the write permit ring is 

inserted in the tape reel. No cassette file may be written unless the file 
protect tabs are in place on the cassette. 

Data is read and written from cassette and magnetic tapes in the same format, 
fixed length blocks of 257 jq words. The first 255 words of each block are data and 
the last two words contain the file number: 



FILE NUMBER 



FILE NUMBER 



DATA 



255 




Files are variable in length, consisting of as many 257 -word blocks as required. If 
the last block is not completely used, the remainder is padded with nulls. 

After the first file and each succeeding file, an end -of -file (EOF) mark is written. 
Two EOF marks terminate the last file, so that all tapes have the following format: 



Start of reel 




File 


(uq blocks) 


EOF 




File 1 


(n^ blocks) 


EOF 




Filek 


(njr blocks) 


EOF 




EOF 





Files must be placed on tape in numeric order. An attempt to place a fourth file 
(MT0:3) on a tape containing only MT0:0 and MT0:1 will cause an error indicating 
FILE NON-EXISTENT. 
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CASSETTE AND MAGNETIC TAPE FILES (Continued) 

Physical Characteristics of Cassette and Magnetic Tapes (Continued) 

Since consecutive EOF marks always indicate the end of tape to SOS, overwriting 
a file makes any previously succeeding files inaccessible. For example, if file 3 
were overwritten on a tape containing 13 files (files 0-12), files 4 though 12 would 
become inaccessible and an attempt to reference any file greater than 3 would result 
in a FILE NON-EXISTENT error. 

System commands described in later chapters are used to initialize a tape drive and 
release a tape drive. The CLI "INIT" command causes a tape on that drive to be 
rewound and initialized. Full initialization (INIT/F) causes the tape to be rewound 
and two EOF's to be written. An INIT/F should be performed on all blank (new) 
magnetic tapes and cassettes before using them. The RELEASE command causes 
the tape to be rewound and then released from the system. 

If a parity error is detected during reading, the system attempts to reread data 
ten times before issuing a FILE DATA error. If an error is detected after writing, 
the system will attempt to backspace, erase and rewrite ten times. If the rewrite is 
unsuccessful after ten times, a FILE DATA error is returned. 

Opening Magnetic Tape and Cassette Files 

A cassette or magnetic tape file is opened using the .OPEN command (see page 4-8). 
When performing an . OPEN command under RDOS-SOS, AGO must contain a byte 
pointer to the unit, name/file number. Hie string for the pointer has the format: 

MTnrdd 

where: n is the unit number (0-7) of the magnetic tape unit, 
dd is the file number (0-99). 

Either a one -digit or two-digit number may be used to reference file numbers 
0-9. File number 8 on unit 2 could be referenced as: 

MT2.-08 or MT2:8 
CT2:08 or CT2:8 
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CASSETTE AND MAGNETIC TAPE FILES (Continued) 

Opening Magnetic Tape and Cassette Files (Continued) 

An example of this would be: 

LDA 0»FILE8 ; LINKS THE FILE 

.SYSTM 

. OPEN 3 ;SPECIFY CHANNEL (0-76 OCTAL) 

error return 



normal return 



FILE8: .+ 1*2 

.TXT *MT2:08* ;FILE 

Thus, channel number 3 is linked to the file (MT2:8) as specified by the byte pointer. 
Once the file has been opened, the file is then referenced by channel number 3, 

Under Standard SOS, the fixed channel number is given in the .OPEN command 
(20-27 for magnetic tapes and 30-37 for cassette units). AGO contains the file 
number, which in this case can be any positive number from 0-99 10 . For 
example : 



LDA 0, FILES 

.SYSTM 

.OPEN 22 ;MT2 

error return 

normal return 



FILE8: 8. ;FILE NUMBER 

or 
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CASSETTE AND MAGNETIC TAPE FILES (Continued) 

Opening Magnetic Tape and Cassette Files (Continued) 





LDA 0, FILE8 




LDA 2, CHNO 




.SYSTM 




. OPEN 77 




error return 




normal return 


FILE8: 


8. 


CHNO: 


22 



;77 8 IS DEVICE CODE OF CPU 



;FILE NUMBER 
;MT2 



The second example illustrates that a channel number need not be specified in the 
command itself. The device code of the CPU is specified in the . OPEN command 
and the system uses the channel number passed in AC2. Note that FILE8 was a 
byte pointer in ACO for RDOS-SOS but simply contains a file number for Standard 
SOS. 
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CHAPTER 3 
SOS UTILITY PROGRAMS 

INTRODUCTION 

This chapter describes the operation of each of the SOS Utility Programs in detail. 
These utilities are supplied to users in three forms: 

1. Relocatable Binary 

2. Absolute Binary 

3. Core Image or Save files 

The absolute binary and save file versions are preconfigured with I/O support for all 
common SOS devices. The relocatable binary versions permit a user to tailor each 
utility exactly to his device configuration. Chapter 5 describes these procedures 
in detail. 

The utility programs that are available for all SOS environments are the following: 

SOS Text Editor 

SOS Extended Assembler 

SOS Library File Editor 

SOS SYSGEN 

SOS FORTRAN Compiler (requires minimum 16K core) 

SOS environments that include at least one cassette or magnetic tape drive qualify 
for three additional utilities: 

SOS Relocatable Loader 

SOS Command Line Interpreter 

Core Image Loader/Writer 

PAPER TAPE OPERATION 



SOS utility programs can be 'operated using the binary loader to load absolute binary 
paper tapes from the high.-speed paper tape reader or the teletypwriter paper tape 
reader. The procedures for loading programs in this manner are described in Section 

2. 8 of "How to Use the Nova Computer. " 
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CASSETTE/MAGNETIC TAPE OPERATION 

Systems with one or more cassette or magnetic tape drives have two additional 
means of loading the SOS utilities: 

1, Via the Core Image Loader 

2. Via the CLI "BOOT' command 

Files are specified to the Core Image Loader by unit number /file number (see 
the following explanation). Files are specified to the CLI "BOOT" command by 
either filename (CT0:4, MT2:0, etc. ) or by utility mnemonic (ASM, EDIT, FORT, 
etc. ). To load utilities by mnemonic, the CLI assumes the following order of these 
programs on unit : 

File : Core Image Loader /Writer 

File 1 : Relocatable Loader 

File 2 : Command Line Interpreter 

File 3 : Text Editor 

File 4 : Extended Assembler 

File 5 : Library File Editor 

File 6 : SYSGEN 

File 7 : FORTRAN IV Compiler (optional) 

A reel of magnetic or cassette tape with this arrangement of save files is called 
a master reel. Procedures for generating a master reel are discussed in Chapter 
5, Configuring SOS Utility Programs. 

SYSTEM CONSOLE BREAKS 



There are two possible program breaks that can be generated at a system console: 
CTRL A and CTRL C breaks. The treatment of these breaks is generally consis- 
tent throughout the SOS utilities. 

Pressing CTRL and A on a console keyboard causes the currently executing utility to 
stop, initialize, and re -issue its prompt message. For example if the CLI were 
performing a File Compare when this break was entered, the compare (and conse - 
quent listing) would terminate and the CLI prompt message (R) would be re -issued 
to the console. If this break was entered during an assembly, the assembly would 
terminate Immediately and the assembler prompt message (ASM) would be re- 
issued. All SOS utilities except die Editor treat the CTRL A break in this manner. 
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SYSTEM CONSOLE BREAKS (Continued) 

The SOS Editor treats the CTRL A break somewhat differently. If the break is 
entered while one of the following Editor commands Is in progresss: 

T» Y, N» E, or P 

then the operation is terminated and the program restarts with I/O reset but with 
the Input buffer intact. If this break is entered at some other time while the Editor 
is executing, it is ignored. 

Pressing CTRL and C on a console keyboard causes an immediate transfer to the 
Core Image Loader program (and is consequently ignored by all non-cassette or 
magnetic tape utilities). This program issues its prompt message (#) and waits 
for the user to specify the next program to be loaded. It is very convenient when 
executing from a master reel (see Chapter 5) to use this feature to swap the utilities 
in and out of core. All program activity terminates immediately when this break is 
entered. All appropriately configured SOS utilities except the Editor treat the 
CTRL C break in this manner. 

The SOS Editor ignores this break however. To return to the Core Image Loader 
from this utility, the "H" command must be issued. 

The section on the User Status Table, page 4-30, describes the means available for 
.employing these breaks by user programs. 



3-3 



CORE IMAGE LGADERAVRITER 

The core image loader /writer Is a utility program that performs two functions: it 
loads core image files from cassette or magnetic tape into core and produces core 
image or save files on cassette or magnetic tape from the contents of core. There 
are two versions of the core image loader/writer -- one for use with cassette drives 
and another for use with magnetic tape drives. The cassette version works only 
with cassettes and the magnetic tape version works only with magnetic tape. Both 
versions when loaded occupy the last 400g locations in core. 

installation Procedure 

The absolute binary version of the Core Image Loader /Writer, when loaded into core, 
permits the user to install it on unit 0, file of the appropriate tape. The program 

types the message 

LOAD UNIT 0: STRIKE ANY KEY 

at the system console. When a tape reel that is not write protected is mounted on 
unit and the unit is ready, the user may depress any teletype key. The program 
then writes the appropriate subset of itself to file of that unit. When this write 
operation is complete, the message 

LOADER INSTALLED 

Is typed at the system console and the program HALTs. This tape reel is now usable 
for the Bootstrap Procedure described below. The Installation Procedure may be 
repeated; depress the CONTINUE switch on the master console and the LOAD UNIT 0: 
STRIKE ANY KEY message will be issued, A new tape reel may be mounted on unit 

0, or the unit assignments changed and the procedure repeated. 



Bootstrap Procedure 

The core image loader /writer can be bootstrap -loaded from file of trie master 

cassette or magnetic tape reel. The master reel must be installed on cassette 
or magnetic tape unit and the drive must be rewound manually. This can be 
done by pressing the REWIND button on the drive unit. 

For machines without the Program Load option, deposit 060134 (for cassette units) 
or 060122 (for magnetic tape units) into location 376 g , and deposit 000377 into 
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Bootstrap Procedure (Continued) 

location 377g, Press the console switches for RESET and then START. 

For machines with the Program Load option, set the data switches on the console 
to 100034 (for cassette units) or 10022 (for magnetic tape units), press RESET 
and then PROGRAM LOAD, 

The core image loader/writer is read into page zero initially and then relocates itself 
to the high end of memory. At the end of the relocation process, the loader outputs 
a prompt (#) on the teletype. This prompt indicates that the core image loader is 
ready to accept a command. Whenever the core image loader/writer is resident 
in core, the core image loader may be restarted by setting the data switches to the 
address of the last location in memory, pressing RESET, and then pressing START. 
The core image writer can be started by setting the data switches to the address of 
the next to last location in core, pressing RESET and then pressing START. 

Core Image Loader Operation 

Having issued the # prompt on the teletype, the core image loader waits for an operat- 
er response of a device number (0-7) and a file number (0-99) separated by a colon. 
Device need not be specified. For example: 

#2:7) (unit 2, file 7) 

#4 ) (unit 0, file 4) 

The indicated cassette or magnetic tape file is loaded from the specified device 
into memory, starting at the address specified in location 2. If the A key is struck 
instead of the carriage return after the unit and file entry, the loader will halt after , 
loading is complete. For example: 

#1:2 A 

causes file 2 of unit 1 to be read into core followed by a HALT. 

Hie Core Image Loader always sets the UST CTRL C break location (USTBR) to point 
to itself after it loads a program. Hie loaded program may then ignore, disable, or 
change this location. (See User Status Table, page 4-20. ) 

If the core image loader encounters a non -recoverable error while trying to load 
a core image file, it will type 

*ERR 

and halt with the cassette or magnetic tape status word in AGO, The following list 

describes the error conditions assigned to each bit in the status word, 
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Core Image Loader Operation (Continued) 

BIT MEANING 

1 Data late (perhaps due to a long indirect access chain or a faster 

device preempting the channel. 

3 Illegal command 

5 Lateral parity error in a word 

6 Addressed tape is beyond the EOT marker 
8 Addressed tape is at load point 

10 Bad tape (e.g. , data is found in an interrecord gap) 

13 Unit is write locked 

14 Odd number of bytes detected in a read or write attempt 

If rewinding and substituting a fresh cassette or magnetic tape does not cure an error 
condition, a hardware malfunction is indicated; run the appropriate diagnostic 
program. 

Core Image Writer Operation 

The core image writer operates in a manner similar to that of the core image loader. 
When the core image writer is started (see page 3-5), it outputs a # prompt and waits 
for specification of a device number and a file number separated by a colon. Unit 
need not be specified. After the file has been specified, the core image writer will 
request specification of the upper core address (NMAX) to be written onto tape. It 
does this by typing: 

NMAX: 

on the teletypewriter. Hie operator must then respond with the highest core address 
(in octal) whose contents he wants written into the core image cassette or magnetic 
tape file. Upon detection of a non- recoverable error, the core image writer proceeds 
in the same way as the core image loader. After completing a successful write, the 
program types OK and HALTS, 
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COMMAND LINE INTERPRETER (CLI) 
CLI Definition 

The Command Line Interpreter (CLI) is a system program that accepts command 
lines from a system console and translates them into commands to the operating 
system. The CLI acts as an interface between the user at the console and the 
system. In addtion, the CLI performs certain file housekeeping chores for the 
user and Implements loading of other utility programs from a master cassette or 
reel. 

To use the CLI, the core image loader must be resident in core and a master cassette 
or reel mounted on CTO or MTO. A 0:2 command following the # prompt will load 
the CLI. 

Ready Message 

The CLI indicates to the user that the system is idle and that the CLI is ready to 
accept commands by typing a ready message on the console. The message consists 
of "R" followed by a carriage return. 

CLI Activation 



The user activates CLI responses to a command by typing a line and pressing the 
RETURN key or the CTRL L (form feed) keys. The CLI will not respond until 
RETURN or CTRL L is pressed. (RETURN and CTRL L are interchangeable; use 
of RETURN -- shown as ) -- in the remainder of the text means either line termin- 
ator. ) 
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Symbols and Conventions Used in Command Line Syntax 

Symbol Usage 



) 



Represents pressing RETURN key, causing 
termination of the command line input and 
activation of the CLI. 

Represents pressing CTRL L keys (form 
feed) which acts the same way as the 
RETURN key. 



Example 
PRINT $FTR ) 

TYPE $PTR 1 



\ 



A (space) 



/ 



t (SHIFT N) 



(,,») 



Note ; 



Represents pressing SHIFT L keys, which 
causes deletion of the entire line.X ) are 
echoed on the teletypewriter. 

Represents pressing RUBOUT key, which 
causes erasure of the previous character. 
— is echoed on the teletypewriter. 

Arguments are separated by commas or 
spaces. Extra commas and spaces have 
the same effect as a single symbol. (Note 
that only commas can be used as argument 
separators when used with parentheses. ) 

Right slash indicates that the character 
immediately following is to be interpreted 
as a switch. 

Command delimiter in a command line. 
Two or more commands may appear on a 
line separated by semicolons; none are 
executed until RETURN is pressed. 

The next RETURN is ignored as a command 

terminator, t must appear as the character 
immediately before a carriage return. 

Repetition of commands or arguments. 



FILCOM \ ) 



FF-ILCD-OM 



TYPEA$PTRACTO:0) 

TYPEA$FTR,ACTO:0) 

TYFEA$PTR,AACTO:0) 

TYPEA$FTR,A,CTO:0) 



XFER/A $PTR $FTP) 



INIT MTO; INIT MTl ; 



PRINT $PTR/2 MT0;3t) 
MT0;4 $CDR $PTR ) 



PRINT MT0:(0, 1,2,3)) 



Use of these symbols and conventions is described in greater 
detail in sections following. 
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COMMAND LINES 

A command line can consist of one or more commands followed by RETURN, A 
basic command line has one command. 

The CLI command may be used to invoke a utility, invoke any file, or to perform a 
function. In the case of utility programs, the CLI presumes a sequence of save files 
on the master cassette or master reel and finds the appropriate program based on 
that assumption. If, for example, the user types the following command line; 

BOOT ASM ) 

the CLI will load the assembler into core. The effect Is the same as a 0:4 command 
to the Core Image Loader. The CLI is overwritten in core by the assembler and 
may only be restored to core by specifying the physical save file on which it resides 
(e.g. 0:2) to the Core Image Loader for loading. 

Similarly, 

BOOT CT1 :2 ) 

will load the third file on unit one with the CLI being overwritten. It may be re- 
stored in the same manner as above. (Note: CT1:2 and CT1:02 are synonymous.) 

However, for the command: 

BOOT $PTR j 

the Core Image Loader is replaced by the absolute binary loader for the purpose 
of loading absolute binary paper tape. 

When performing a function, the CLI is not overwritten but merely executes the 
specified function and returns after the function is completed with the prompt 

message R. If, for example, the user types the command line: 

FILCOM MT0:0 CT1:2 $LPT/L ) 

file MT0:0 is compared to file CT1:2 and dissimilar word pairs are printed In 
octal with their file displacement on the line printer. The CLI returns with the 
prompt R, 
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A command line is executed by the CLI when the user presses the RETURN key or 

the CTRL L keys on the console. 

A number of commands may be stacked on a given line for execution. They are 
separated by semicolons. For example; 

APPEND MT0:0 $PTR; GTOD; FILCOM MTO.-O MTlri; BPUNCH MT0:0 MT1:3) 

The four commands are executed when the user presses RETURN. The CLI 
indicates execution of each command with the appropriate information, if any. At 
the completion of the entire command line, the CLI will prompt the user again with 
a ready message. For example, the previous command line will cause the response: 

LOAD $PTR, STRIKE ANY KEY - Prompt message for APPEND 

05/22/74 18:48:40 -• Response to GTOD 

R - After MT1:3 is "BPUNCHed" 

Long Command Lines 

Each command line is limited to 132 characters in length*, although this may be 
extended by typing the symbol t immediately before pressing the RETURN key. The 
up arrow causes the carriage return to be ignored. For example: 

INIT CT2; PRINT CT0:2; PUNCH CT0:2; DUMP MT0:0 t ) 
CT0:3/S FORT. LB ) 

Is executed as if the following had been typed: 

INIT CT2; PRINT CT0-.2; PUNCH CT0:2; DUMP MT0:0 CT0:3/S FORT. LB ) 

In the previous example, the second line starts a new argument. Note that when a 
RETURN is ignored, there is no delimiter between the last character on one line 
and the first character on the next line. Therefore, in the example the blank argu- 
ment delimiter has been inserted before the up arrow. 
The user can, of course, break an argument or command word into two lines: 

INIT CT2; PRINT CT0:2; PUNCH CT0:2; DU f ) 
MP MT0:0 CT0;3/S FORT. LB) 

is equivalent to: 

INIT CT2; PRINT CT0:2; PUNCH CT0:2; DUMP MTO.-O CT0:3/S FORT. LB ) 



* The maximum length of all commands input to the CLI at any one moment is 300 
characters (not counting t up arrows). 
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Switches 

Commands and their arguments may be modified by a series of switches pertaining 
to the command or argument, A switch is indicated by a right slash {/) followed 
immediately by either a letter or a decimal digit. 

Numeric switches specify the number of times the previous argument is to be 
repeated in the command line. For example: 

PRINT $PTR/6 ) . 

indicates that six ASCII tapes from the paper tape reader are to be printed by the 

line printer. 

Numeric switches are cumulative. The following commands are equivalent: 

PRINT $PTR/l/3/2) 

PRINT $PTR/6 ) 

The digit 1 in a numeric switch is the same as no switch. The following commands 
are equivalent: 

PRINT $PTR ) 

PRINT $PTR/1) 

The digit has no effect upon the number of times a file name Is repeated if it 
appears in a list of numeric options. For example, the following commands are 
equivalent: 

PRINT $PTR/6 ) 

PRINT $PTR/l/0/2/3) 

PRINT $PTR /1/2/3/0/0 ) 

However, when used alone, the switch has the same effect as 1, For example, 
the following are equivalent commands: 

PRINT $PTR/1 ) 

PRINT $PTR/0 ) 
PRINT $PTR ) 
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Switches (Continued) 

Letter switches have distinct meanings that depend upon the command or argument 
with which they are associated. The detailed descriptions of each CL! command 
indicate the meanings of each letter switch that can be used in the command. 

A letter switch that follows a command word is a global switch and applies to all 
arguments of the command line, A switch that follows an argument is a local switch 
and applies only to the particular argument. For example, the Make Abso lute 
Binary command (MKABS) has both a local and global switch, S , to specify the 
address that is placed in the start block of the absolute binary file that is produced. 
The command: 

MKABS MT0:1 $PTP J 

causes the save file on MT0:1 to be punched in absolute binary format on the high 
speed punch. The start block on the tape will have an address of zero which 
causes the binary loader to HALT after the tape is loaded. 

The global switch, S, causes the address contained in the UST location USTSA to be 
placed in the start block. This address represents the relocated address of the 
last relocatable binary start block that passed through the loader when the save file 
was generated. Hence the command: 

MKABS/S MT0:1 $PTP ) 

causes such a block to be produced in the absolute binary tape. When the binary 
loader completes the loading of this tape, the program will begin execution at its 
starting address. 

The local switch, S, causes the octal address that it modifies to be placed in the 
start block. This feature is useful for cases where a starting address is missing 
from the save file or an address other than the user specified address at USTSA is 
desired. An example of such a command is: 

MKABS MT0:1 $PTP 377/S ) 

Effect of Switches on Command Lines 



A switch affects a command line as if the switch were a comma or space. For 
example, the following commands are equivalent: 

MKABS/S MT0:1 SFTP ) 
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Effect of Switches on Command Lines (Continued) 

MKABS /S MT0.-1 $FTP ) 

MKABS/SMTO:! $FTP ) 

Thus the switch delimits the command word MKABS from the argument MT0:1. 

If a character other than a number or a letter follows the right slash, the slash acts 
merely as a delimiter. For example, 

MKABS/ S MT0.-1 $PTP ) 

The slash is ignored because it is followed by a space. Since there is no SOS 
file or device named S, an error message will result, 

Comma/Parenthesis Convention 



CLI commands can be repeated with each of several arguments or argument strings 
by first separating the arguments or strings with commas and then by enclosing all 
the arguments within single parentheses. Moreover, a series of commands can be 
made to use a common argument by placing the commands within single parentheses, 
The general form of the convention is: 

SI (S2, S3,..., Sn) Sn+1 ... ) 

where: SI. . , Sn+1 are strings within the command line sequence. 

Use of the above generalized form results in a series of commands which are 
executed serially by the CLI: 

SI S2 Sn+1...) 

SI S3 Sn+1... ) 

SI Sn Sn+1 . . , ) 

Only one set of parentheses is permitted per command line. Neither command 
terminators (carriage return, form feed, semicolons, additional left parentheses) 
nor nulls can be present within the parentheses. Use of this convention to compare 
a series of tape files is illustrated In the single command: 
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Comma/Parenthesis Convention (Continued) 

FILCOM (MT0.-1 MTl;2 f MTO.-O CT0:0) $LPT/L ) 
the CLI expands this command into the following pair of CLI commands; 

FILCOM MT0:1 MT1:2 $LPT/L ) 

FILCOM MTOrO CT0;0 $LPT/L ) 

Use of comma without argument strings within parentheses is permitted under 
limited conditions. If the parentheses with commas are preceded by a single 
command, the command will be repeated n+1 times for n commas. 

GTOD(,„) ) 

is equivalent to: 

GTOD) 

gtod) 

GTOD) 

gtod) 

Messages Concerning I/O 

Some commands require manual operation of an I/O device. If the user issues such 
a command, he will receive a message prompting or instructing him as to the proper 
action. For example, if the user issues the command: 

XFER/A $PTR MT0:0 ) 

which requests that a source file be transferred from the paper tape reader to a 
magnetic tape file named MT0:0 the system replies: 

LOAD $PTR, STRIKE ANY KEY. 

The user can then mount the paper tape in the reader and strike any key on the 
console. The key struck to start the device is not echoed on the console. 

When a series of files are to be transferred, or loaded from a device requiring 
manual intervention for each file, the message will be issued the appropriate number 
of times. For example, if the user issues the command: 

APPEND MT0:0 $PTR/2 ) 
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Messages Concerning I/O (Continued) 

which requests that the file MT0:0 be created from two files input from the paper 
tape reader, the following messages will occur: 

LOAD $PTR, STRIKE ANY KEY. 

LOAD $PTR, STRIKE ANY KEY. 

The second message is typed out after the first file has been transferred. 

Error Messages 

When the user issues a command that contains an error, an appropriate error 
message will be typed out. 

When a user gives a command that is legal for some arguments and illegal for 
others, an error message is issued for each of the illegal arguments. The correct 
portions of the command are executed. For example, 

R 

APPEND CT1:3 CT2:4 MT1:5 ) concatenate two files to CT1:3 

R 

XFER $PTR CT0:2 ) transfer file from $PTR to cassette 

LOAD $PTF, STRIKE ANY KEY. 

R 

FILCOM CT1:3 CT0:2 CT2:4) 

TOO MANY ARGUMENTS. 

R 

FILCOM CT1:3 CT0:2 $TTI/L ) 

FILE WRITE PROTECTED: FILE $TTI. 

R 

FILCOM CT1:3) 

NOT ENOUGH ARGUMENTS no action occurs 

R 

FILCOM CT1:3 CT0:2 ) correct arguments; listing to $TTO 
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Error Messages (Continued) 

In general, error messages are quite explicit, giving the user sufficient information 

to correct his error easily, A few examples are shown: 

R 

MT0:4 ) 

NOT A COMMAND; MT0:4 correct command is BOOT MT0:4 

R 

XFER MT0:3 $PTR ) 

FILE WRITE PROTECTED: FILE $PTR 

R 

INIT $PTR ) 

NOT A DIRECTORY DEVICE: $PTR 

R 

MKSAVE $PTR MT3.-74 ) 

OUT OF SPACE: FILE MT3:74 

R 

XFER MT4:5 MT2:7 ) 

FILE DOES NOT EXIST: FILE MT2:7 

R 

XFER $TTO $PTP ) 

FILE READ PROTECTED: FILE $TTO 

R 

INIT CT8 ) 

NOT A DIRECTORY DEVICE :CT8 

R 

BOTO CT1.-2 ) 

NOT A COMMAND: BOTO 

R 
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CLI Commands 



This section contains definitions and descriptions of each of the CLI commands. The 

commands are listed in alphabetical order at the bottom of the page and described 

in that order on pages following. 

The following conventions are used to define individual CLI command formats: 

All upper case letters represent valid command line elements. 

Items in a command line printed in lower case indicate either command 
information or file names which must be supplied in the command line. 



Elements enclosed In modified brackets, [ ] 
indicate alternate choices. 



are optional. Stacked items 



The ellipsis (...) is used to indicate that preceding file types or bracketed 
material may be repeated if desired. 

The comma (, ), and right slash ( / ) are significant and necessary parts of 
any command line definition in which they are found. 



APPEND 
BOOT 

BPUNCH 

COPY 

DEB 

DUMP 

FILCOM 

GTOD 

INIT 

LOAD 

MKABS 

MKSAVE 

PRINT 

PUNCH 

RELEASE 

SDAY 

STOD 

TYPE 

XFER 



Concatenate two or more files. 

Invoke a utility program or load any file. 

Copy a binary file on $PTP. 

Copy a cassette or magnetic tape reel. 

Start a program about to be executed in the Debugger. 

Produce a dump format file. 

Compare two files. 

Get time and date. 

Initialize cassette or magnetic tape. 

Reload dumped files. 

Make an absolute binary file from a core image or save file. 

Make a save file from an absolute binary file. 

Print an ASCII file on the line printer. 

Copy an ASCII file on the $PTP. 

Release cassette or magnetic tape. 

Set today's date. 

Set the time. 

Output the contents of an ASCII file on the system console. 

Copy a file to another file. 
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CLI Commands (Continued) 

Name; APPEND 



Format; 
Purpose ; 

Switches; 



APPEND newfilename oldfilename ^. , . oldfilename } 

To create a new file, consisting of a concatenation of one or 
more old files in the order in which their names are listed 
as arguments. The old files are not changed by the command, 

None. 



Examples: APPEND MT0;0 CT1;1 CT1.-2 CT1.-3 CT1;4 ) 

causes creation of the file MT0;0 containing the contents 
of files CT1:1 CT1.-2 CT1:3 CT1;4 in that order. 

APPEND CT0:0 CT1:2 MT1.-0 CT1;1 $PTR ) 

causes creation of the file CT0;0 containing the files CT1;2, 
MT1;0, CT1;1 and the paper tape reader. 

The same device cannot be used for both input and output files, 
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CLI Commands (Continued) 
Name: BOOT 



Format: 



Purpose: 



Mnemonics: 



Switches: 
Local: 



Examples: 



BOOT filename 



To invoke a utility program or any executable file. To boot 
a utility program the following are used: 

ASM - load the Assembler 

EDIT - load the Text Editor 

FORT - load the FORTRAN IV compiler 

LFE - load the Library File Editor 

RLDR - load the Relocatable Loader 

SYSG - load SYSGEN 

CLI - load Command Line Interpreter 



/A 



modifies the filename and causes the Core Image 
Loader to HALT instead of starting the program afer 
it is loaded. 



BOOT EDIT ) 

loads and starts the Editor from a master reel. 

BOOT RLDR/A ) 

loads the Relocatable Loader from a master reel and HALTs, 

BOOT $TTR ) 

LOAD $TTR, STRIKE ANY KEY 

loads an absolute binary tape from the teletypewriter reader, 

BOOTCT1: 2 /A ) 

causes file 2 on cassette unit 1 to be loaded and HALTs. 
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CLI Commands (Continued) 
BPUNCH 



Name : 
Format: 

Purpose: 



Switches: 
Examples: 



BPUNCH filename j £ filename 2 . . . } 

To punch a given file or files in binary on the high speed punch. 

The command is the equivalent of a series of XFER commands: 

XFER filename $PTP;. . . ;XFER filename $PTP ) 
]_ n 

The files may come from any input device. 

None. 

BPUNCH MT0:0 MT0.-1 CT0:3 $PTR ) 

causes files MT0:0,MT0:1, CT0:3, and $PTR to be punched on the 
high speed punch. 

BPUNCH $PTR ) 

causes a duplicate of the paper tape in the high speed reader to 
be punched. 
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CLI Commands (Continued) 



Name: 
Format: 



Purpose : 



COPY 



COPY so'-'r'./: :'-."*. -' ationfile 



where: souxcefile and dsslmMmrOii^ are cassette or magnetic 
tape files 

To copy a cassette or magnetic tape reel to another cassette or 
magnetic tape reel. The specified sourcefile denotes the beginning 
of the input reel. The specmed destlnaOonfile denotes the beginning 
of the output reel. Each subsequent file on the input reel is copied 
to a subsequent file on the output reel, until the end of reel ( or 
double EOF mark) is detected on the input reel. The double EOh i 
are also copied to the output reel, 



Switches: 
Global: 



/V - Verify each file that is copied on the system console, 



Examples: COPY CT0:0CT1:0 : 



copies the entire reel on cassette unir 3 ;•; the reel on cassette 
unit 1 . 

COPY A 7 MT1:3 MT0:5 ) 

copies all files on magnetic tape unit .1, beginning at file 3, to 

magnetic tape unit 0» beginning at file 5. Each file that is copied is 
verified on the system console. The copy continues until a double 
EOF is encountered on unit 1. 
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CLI Commands ( Continued) 

Name: DEB 



Format: 
Purpose : 



Switches: 
Global: 

Local: 

Example: 



DEB filename 



To debug a program which is about to be loaded and executed. The 
SOS Debugger, SDEB, or the RTOS/RDOS Debugger, IDEB, must 
have been included in the load module produced by the RLDR, The 
program save file must reside on magnetic or cassette tape. This 
command is identical to "BOOT" except that control is given to the 
address at the UST location USTDA instead of USTSA. 

When debugging, memory can be examined, break points set, the 
program run, etc. After making any necessary changes in the pro- 
gram, the user can preserve the core image of the program by 
issuing the $V Debug command (SDEB only) and writing out the 
save file using the Core Image Writer. 



None 

/A - HALT after loading the program; do not start the Debugger. 



DEB CT1:5 

1004/ ADD 2 ADD 2 

$-.v 

#1:5 

NMAX: 16200 
OK 

$R 



- Debug CT1:5 

- Change program 
r $V break issued 

- Old save file is specified for the modified 
program 

- NMAX is specified 

* File has been rewritten to CTl:5 

- CONTINUE key causes return to Debugger 

- Program is started at the beginning address 
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CLI Commands (Continued) 



Name: 
Format: 

Purpose: 



DUMP 

DUMP outputfilename filename f filename 2 . . . 3 t } 

£ oldfilenam e/S newfilename^ . . . } 

To produce a dump format file (see DGC 093-000075, Appendix F) 
of a given file or files. This facility is desirable for SOS users 
who 

• wish to back up cassette or magnetic tape files on 
paper tape. 

• transfer SOS files to an RDOS system. The checksum 
information in dump files assures the exactness of the 
transfer. 

When the local switch, S, is not used to dump a file, the name that 
is placed in the name block of the corresponding dump file record 
is the SOS filename, such as CT0:2, MT1:0, $PTR,etc. 



Switches: 
Global: 



/L 
/S 



list the dumped files on the $LPT (overrides /V). 

dump a file to paper tape ($TTP or $PTP) in segments, 
The file is punched in segments of up to 16K bytes 
each. An attempt to dump to a file other than $TTP 
or $PTP causes the error printout: ILLEGAL FILE- 
NAME 



Local: 



Notes: 



/V 
/S 



verify dump with a list of names of dumped files on 
the console. 

assign the following name to the record output in the 
dump file. 



The /S global switch is used to segment backup paper tapes that 
would otherwise be difficult or impossible to handle as a single tape, 
for example the FORTRAN IV compiler. Each segment of tape is 
punched with a unique segment number enabling the system to verify 
that tapes are later reLOADed in proper sequence. Appropriate 
leader and trailer and continuation blocks mark the segmentation of 
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CLi Commands (Continued) 

Notes: the paper tape. It is the user's responsibility to separate the tapes 

(Continued) after punching and mark them for his use. Failure to load the 

proper tape in the proper sequence causes an error message to be 
printed. The message is shown under Notes in the LOAD command. 

Examples: 

DUMP/L MT0:0 CT0:0/S FORT. LB CT1:0/S CILWCT.SV CT1:1/S PARU.Sr) 

causes CT0:0 to be dumped with the name FORT. LB, CT1:0 to be 
dumped with the name CILWCT.SV, and CT1:1 to be dumped with 
the name PARU.SR. All are dumped as the first file on magnetic 
tape unit 0. The dumped files will be listed on the line printer. 
They would be specified as FORT. LB, CILWCT.SV, and PARU.SR 
when reloaded by the LOAD command. (See LOAD command, page 
3-28.) 

DUMP MT0:0 CT1:23 CT2:4 ) 

causes the 24th file on cassette unit 1 and the 5th file on cassette 
unit 2 to be dumped onto the first file on magnetic tape unit 0. The 
names CT1:23 and CT2:4 will be retained on the dump file and when 
reloaded by the LOAD command would be specified as such on the 
console. 
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CLI Commands (Continued) 



Name : 

Format: 

Purpose: 



FILCOM 

FILCOM filename fflename 2 f listing file /L } 

To compare two files, word by word, and print dissimilar word 
pairs. Dissimilar word pairs at the same displacements in the 
two files are printed on the console if the /L switch is not used. 
Words are printed in octal and their displacements hi the file are 
also printed. File organizations of the two files may differ. 



Switches: 
Local: 

Example: 



/L - Hsting file 

FILCOM MT0:0 MT1:3 $LPT/L ) 

causes a word -by -word comparison of the contents of the files 
MT0:0 and MT1:3. Any dissimilar word pairs will be printed in 
octal on the line printer, along with their respective word dis- 
placements in the files: 



000025/ 


044516 


042530 


000141/ 


000014 


020044 


000142/ 


000000 


046120 


00)143/ 


000000 


052057 


000144/ 


000000 


046015 


000145/ 


000000 


000014 



If MT1:3 were a null file, the entire contents of file MT0:0 would 
be printed. Dashes would be printed for file MT1:3. 

If the files to be compared wraparound after the first 64K words 
compared, the beginning of the second 64K words compared (and 
any subsequent 64K words compared will be indicated by the fol- 
lowing printout preceding the word pair comparisons: 

PLANE mi 

where: nn is two digits indicating which 64K words are being com- 
pared as follows: 

01 - second 64K words compared 

02 - third 64K words compared 
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CLI Commands (Continued) 



Name: 


GTOD 


Format: 


GTOD 


Purpose: 


To get the time of day and the current date. 


Switches : 


None, 


Example : 


GTOD } 

2/17/73 21:24:20 

R 



The message indicates that the time is 20 seconds after 9:24 p. m. , 
and the date is February 17, 1973. 
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CLI Commands (Continued) 

INIT 



Name: 



Format; 



Purpose: 



Switches: 
Global: 



Local: 

Examples: 



INIT devicename 

where deyLcename is one of CTO, CT1, . . . CT7 or MTO, MT1, . . , 

MT7 

Initialize cassette or magnetic tape. The cassette or magnetic tape 
unit specified is rewound. If there is no such unit in the system, 
the error message NOT A DIRECTORY DEVICE will be printed on 
the teletype. 



/F 



This switch causes two EOF records to be written 
to the appropriate cassette or magnetic tape at the 
beginning of the tape. 



None . 

INIT CT1 ) 

initializes cassette unit 1. 

INIT/F MTO ) 

initializes magnetic tape unit and writes two EOF records. 
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CLI Commands (Continued) 
Name: LOAD 



Format; 
Purpose; 



Switches; 
Global: 

Local; 



LOAD inputfilename 

To restore a previously dumped file or files. This feature is 
desirable for SOS users who wish to: 

. restore backed up (or dumped) SOS files. 

. transfer dumped RDOS files to Stand-alone Systems 
for use there. 

As the CLI encounters the name block of each record in the dump 
file, it types this name on the system console. The user then 
specifies the file to which this record will be restored in the 
following manner: 

- ) - use the filename typed on the console, as CT0:4 

name ) - use the (user) specified name, such as CT1.-5 instead 
of CT0:4 (from above). 

. ) - use the previous output filename, incremented by one. 

For example, if CT1:5 were specified previously, this 
file would be restored to CT1;6. This response is 
obviously illegal for the first record encountered in 
the dump file. 

J - skip this record and proceed to the next one. 

As the dump file is processed by the CLI, only the desired records 
are selected for output. When all desired records have been restored, 
a CTRL A break may be entered to terminate the command. 

If new names have been assigned to the files during the DUMP - 
such as FORT. LB (see DUMP command) - each new name will be 
typed out on the console as each record is read. In such cases, an 
appropriate output file must be specified. 



/N - Only list the files on the console; do not load. 

None, 
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CLI Commands (Continued) 



Notes 



When reloading a paper tape that was dumped in segments (/S 

global switch to the DUMP command), a failure to load the 
appropriate tape in the appropriate order will cause the fol- 
lowing printout: 

YOU LOADED filename TAPE# rm ) 

I WANT: filename TAPE# mi..... TRY AGAIN ) 

where filename is the name of the file, e.g. , FORT. LB. 

nn is the number of the segment, e.g., 01, 02, 03, ... 



In the case where a second tape is loaded before the first tape, 
the filename will appear only in the first line of the message: 

YOU LOADED filename TAPE# 02 ) 
I WANT TAPE# 01..... TRY AGAIN) 



Examples: LOAD $PTR ) 

(FORT. LB) CT2:0) 
(SOSCT. LB) . ) 
(SOS. LB) CT1:2) 
R 

LOAD MT0:0 ) 

(MT0:00) MT1:0) 
($PTR) ) 

(PARU.SR) $PTP) 
(MT1:1)-) 
R 

LOAD/N CT1:2 ) 

ABC.SR 

DEF.SR 

CT2:3 

JKL.SR 

R 



^restore file to CT2:0 
;restore file to CT2:1 
;re store file to CT1:2 
;end of dump file 



;restore file to MT1:0 

;skip this file 

; re store file to high speed punch 

; re store file to MT1:1 

;end of dump file 



;each dumped file is printed 
;on the system console 



;end of dump file 
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CLI Commands (Continued) 
Name: MKABS 



Format: 

Purpose: 

Switches: 
Global; 



Local: 



Examples: 



MKABS save filename absolute binary filename 

To make an absolute binary file from core image (save) file. 



/S - starting address switch. The starting address of the save 
file as specified in USTSA of the file will be used as the address for 
an absolute binary start block. Default is a null start block which 
causes the binary loader to halt when loading is complete, 

/F - _first address (relative to location of the save file) from 
which the absolute binary file is to be created. 

/S - starting address switch. An absolute binary start block 
will be output with the starting address specified by the preceding 
octal argument, 

/T - last_ address (relative to location of the save file) which 
is to become part of the absolute binary file. 

MKABS MT0:0 $PTP ) 

punches an absolute binary -file to the paper tape punch from file 
MT0:0 

MKABS MT0:0 $PTP 1000/S ) 

punches an absolute binary file with a start block specifying 1000 
as the starting address, 

MKABS /S CT2:1 STTP 0/F 10000/T ) 

punches an absolute binary file with a start block which contains 
the address specified in USTSA. The first 10001 octal locations 

of the save file are included in the absolute binary file that is 
generated at the teletypewriter punch. 
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CLI Commands (Continued) 

MKSAVE 



Name : 

Format: 

Purpose: 

Switches: 

Example: 



MKSAVE absolute -binary -filename save -filename 

To create a core image (save) file from an absolute binary file, 

None . 

MKSAVE $PTR CT0:2 ) 

causes creation of a core image file on CT0:2 from the absolute 
binary file loaded in the paper tape reader. 



3-31 



CLI Commands (Continued) 

Name; PRINT 



Format: 
Purpose: 



Switches: 
Example : 



PRINT filename 1 § filename . . . J 



To print the given file or files on the line printer. Hie command 
is the equivalent of a series of XFER commands. 



XFER/A filename $LPT; . 



;XFER/A filename $LPT ) 



The source files may come from any input device. If a parity error 
is detected, a left slash (\) is printed in place of the bad character, 
and the message "PARITY ERROR" is output on the console; printing 
then continues. 

None. 

PRINT MT0.-2 MT1:0 CT0:3 $PTR ) 

causes source files MT0:2 MT1:0 CT0:3 and the paper tape mounted 
in the high speed reader to be printed on the line printer. 
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CLI Commands (Continued) 

Name; PUNCH 



Format: 
Purpose : 



Switches: 
Examples 



PUNCH filename £ filename . . .§ 

To copy a given file or files on the high speed punch, The command 
is the equivalent of a series of XFER commands: 

XFER/A filename x $PTP; . . . ;XFER/A filename n $PTP ) 

The source files may come from any input device. If a parity error 
is detected, a left slash (\) is punched in place of the bad character, 
and the message "PARITY ERROR" is output; punching continues. 

None. 

PUNCH CT0:0 $PTR $TTR ) 

causes files CT0;0, $PTR, and the paper tape mounted in the 
teletypewriter reader to be punched on the high speed punch. 
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CLI Commands (Continued) 



Name: 
Format; 



Purpose; 



Switches: 
Examples: 



RELEASE 



RELEASE devicename 



where: devicename is one of CTO, CT1» ... CT7, or MTO, MT1 

MT7 

To release a cassette or magnetic tape. The cassette or magnetic 
tape unit specified is rewound. If there is no such unit in the system, 
the error message NOT A DIRECTORY DEVICE will be printed on 
the teletypewriter. 

None. 
RELEASE CT7 ) 

rewinds cassette unit 7. 

RELEASE MT4 ) 

rewinds magnetic tape unit 4. 
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CLI Commands (Continued) 

SDAY 



Name : 

Format: 

Purpose: 

Switches : 
Example : 



SDAY month day year 

To set the system calendar. Only spaces or commas can be used 
to separate the date. This date is never changed by the system. 

None. 

SDAY 4 17 74) 

sets the system calendar to April 17, 1974. 
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CLI Commands (Continued) 
Name: STOD 



Format: 
Purpose : 

Switches: 



STOD hour minute second 



To set the system clock, (The system clock is a 24 hour clock. ) 
Only spaces or commas can be used to separate the time arguments, 

None. 



Example: STOD 21 24 ) 

causes the system clock to be set to 9:24:00 p.m. 
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CLI Commands (Continued) 
TYPE 



'Name : 
Format: 
Purpose: 



Switches: 
Example : 



TYPE filename i f filename 2 . . . 3 

To copy a given file or files on the program console. The command 
is the equivalent of a series of XFER commands: 

XFER/A filename $TTO;. . . ;XFER/A filename n $TTO ) 

The source files may come from any device. When a character 
with bad parity is detected, a left slash ( \ ) is typed and the 
message "PARITY ERROR. " is output; typing of the remainder 
of the file continues. 

None. 

TYPE MT0:1 MT0:2 $PTR CT0:3 ) 

This command causes the following files to be typed or displayed 
on the program console: tape files MT0:1 and MT0;2, a file 
mounted in the high speed reader, and cassette file CT0:3, 
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CLI Commands (Continued) 

Name: XFER 

Format: XFER sourcefile destinationfile 

Purpose: To copy a file. The system will detect parity errors in ASCII 

files, and it will detect parity errors in binary files on magnetic 
or cassette tape. When a parity error is detected in the input 
file, the message PARITY ERROR, FILE: xxx will be output to 
the console. If one or more parity errors are detected in a paper 
tape file, a backslash will be substituted for each bad character. 
If a parity error is detected in a magnetic tape or cassette file, 
the transfer is terminated. 

Switches: 
Global : /A - ASCII transfer. Transfer the file line by line taking 

appropriate read/write action, such as inserting line feeds after 
each carriage return when transfer is from cassette to line printer. 

/I - Ignore input parity on ASCII transfer. The switch is only 

meaningful when used with the /A switch. Normally, parity is 
checked as described under Purpose. 

Local: None. 

Examples: XFER $PTR MT0:3 ) 

causes the file in the paper tape reader to be transferred to the tape 
file MT0:3. 

XFER/A $PTR $LPT ) 

causes $PTR to be printed on the line printer. 
XFER $PTR $PTP ) 

causes another tape to be punched, identical to the one read from the 
paper tape reader. 

XFER CT0:3 CT3:4 ) s 

transfers file 3 on cassette unit to file 4 on cassette unit 3. 
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OPERATION OF SOS UTILITY PROGRAMS 

The Relocatable Loader (RLDR) 

Format: (RLDR) filename 1 /S filename 2 f filename 3 . . . j 

Note that the name of the utility appears above in parentheses. This 
means that the user does not type RLDR as part of the command 
line; RLDR Is a prompt given by the Relocatable Loader indicating 
that the system utility is ready to accept a command line, consisting 
of names of files to be loaded. 



Purpose: 



To produce an executable core -resident file and a core -image ( or 
save) file from relocatable binary files. Both the core-resident and 
core -image file start at address zero. The symbol table is included 
in the files only if SOS Debug has been loaded and then the table 
always follows the program immediately. 

The debugger provided for cassette and magnetic tape systems is 
SOS Debug, found on relocatable binary tape 089-000167 . 

The loading of user ZREL begins at location 50g, and user NREL 
loading starts at location 440 . Locations 400-437 contain the User 
Status Table. Location 405 contains the starting address of the 
loaded program. 

The maximum size of each loaded program cannot exceed the max- 
imum core address less 1325 g . The relocatable loader will type 
symbol tables for programs whose size exceeds that maximum 
value, but the loading process will not be completed for such pro- 
grams. 

Upon completion of each successful load, the message "OK" is 
output and the system halts with the loaded program in core. 



Switches: 
(Local) 



/A causes a listing of the symbol table with symbols ordered 
alphabetically. (The local switch /L must also be given to 
define an output listing device, ) 

/L causes agisting of the symbol table on the output file or 

device whose name precedes the switch. Symbols in the table 
will be ordered numerically by symbol value. 



3-39 



The Relocatable Loader (RLDR) (Continued) 



Switches: 
(Local) 

Continued 



Errors: 



/N set current NMAX (the starting load address) for the file name 
following the switch to be forced to the absolute address 
immediately preceding this switch, 

/P pause before opening this file, 

/S output the save file to the file (either cassette or magnetic 

tape unit) whose name precedes this switch. (Must always be 
present, ) 

/U load user symbols appearing within the file whose name pre- 
cedes this switch, 

/n load the preceding file n times, where n Is a digit from 2 to 9. 

NO INPUT FILE SPECIFIED, 
NO SAVE FILE SPECIFIED. 



No core image output device has been specified with a /S switch. 
SAVE FILE IS READAVRITE PROTECTED 

The save file must permit both reading and writing; only cassette 

and magnetic tape units are permitted as save file devices. 

I/O ERROR nn 

where: nn is one of the following error codes: 



1 

7 
10 

12 



ILLEGAL FILE NAME 

ATTEMPT TO READ A READ- PROTECTED FILE 

WRITE-PROTECTED FILE 

NON-EXISTENT FILE 



Example: $TTO/L/A CT2 : 0/S SPTR CTl":6 16500/N CT1:0 ) 

causes the relocatable loader to load programs into core from the 
paper tape reader ($PTR), file 6 on cassette drive 1(CT1:6), and file 
on cassette drive 1 (CT1:0). The program from CT1:0 is loaded 
starting at address 16500 g (16500/N). A core image file containing 
the loaded programs is written to file of cassette unit 2 (CT2:0/S). 
An alphabetically ordered symbol table Is output on the teletype 
printer ($TTO/L/A). 
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Text Editor 

Format; 

Purpose; 



Switches; 
Errors: 

Example: 



Not applicable, 

'}'-:■ cie -•_ -. / modify ASCII files. The prompt given by t :- " :t 
F Ftor when It is ready to accept editing commands is; * 

The text editing commands are described in the Text Editor User's 
Manual, 093-000018, Note, as described there, that all output files 
must be closed with the GC command. Execution of P oe F commands 
does not insure that the final input page will be written onto the out- 
put file. 

Not applicable. 

See errors given for the Core Image Loader command and those 
given in the Text Editor Manual, Chapter 5. 

After loading and activating the Text Editor, input and output files 
must be assigned, for example: 



GRCT2:3$CWCT1:3$$ 

causes a source file to be read from file 2 of cassette unit 3 
and an output file to be written as file 3 of unit 1, 
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Extended Assembler 

Format: (ASM) filename ,. . » 

(ASM) 1 filename . 

(ASM) 2 filename j, , , 

The parenthesized utility file name (ASM) indicates that ASM is a 
prompt issued by the utility when ready to accept a user command 
line and is not typed by the user. 

Purpose: To assemble one or more ASCII source files. Output may be an 

absolute or relocatable binary file, with an optional listing file, In- 
put files are assembled in the order specified in the command line, 
A cassette or magnetic tape unit may not be used for both input and 
output, nor may It be used for more than one output file. A cassette 
or magnetic tape unit may be used for more than one input file. 

In the above formats, 0, 1, and 2 are keys describing the number 
of passes required. Global switches listed below modify the key 
in a given command line. Action taken by the assembler depends 
upon the key specified in the command line: 

- Perform pass one on the specified input source file(s), 

then halt with the highest symbol table address (SST) in 
AGO. Normally the source file is a Command Definition 
tape. The user may then invoke the core image writer 
to preserve a copy of this assembler on any cassette file, 

1 - Perform pass one and pass two on the specified input files, 

producing the specified binary and listing files. At the 

completion of pass two, the assembler outputs a new 
prompt, ASM, and awaits a new command line. 

2 - Perform pass two only on the specified input files pro- 

ducing the specified binary and listing files. The symbol 
table used for this pass is that produced by the most re- 
cently executed pass one assembly. At the completion 
of this pass, the assembler outputs a new prompt, ASM, 
and awaits a new command line. 
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Extended Assembler (Continued) 

Switches: 

Global: /E suppress assembly error messages normally output to the 

$TTO. 

/T suppress the listing of the symbol _table, 

/U include local (i.e. , user) symbols in the binary output file. 

Local: /B relocatable or absolute binary file is output on the given device. 

/L any output device to which the ^listing is directed. 

/N any input file which is not to be listed on pass 2. 

/P ]>ause before accepting a file from a device. The message: 

PAUSE - NEXT FILE, filename 

is output by the assembler which waits until any key is struck 
on the teletypewriter console. 

/S £kip this source file during pass two. 

/n_ repeat the given input source file n times, where n is a digit 
from 2 to 9. 

Errors: NO .END 

No . END statement in any source file. 

I/O ERROR nn 

where: nn is one of the following error codes: 

1 - ILLEGAL FILE NAME 

7 - ATTEMPT TO READ A READ-PROTECTED FILE 

10 - WRITE -PROTECTED FILE 

12 - NON-EXISTENT FILE 
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Extended Assembler (Continued) 

Examples: 1 CT1:0/B $LPT/L CT0:0/S CT0:1 CT0:2/N ) 

causes a two-pass assembly to be executed using cassette files 
0, 1, and 2 on unit as input files, A binary file is produced on 
unit 1, file 0, and a listing file is printed on the line printer. On 
pass 2, input file CT0:0 is skipped, and input file CT0:2 is not 
listed. 

2/U CT0;13 CT0;14 CT0:18 CT0:8 CT1:1/B CT2:0/L ) 

causes the second pass of an assembly to be executed on input files 
13, 14, 18 and 8 (in that order) on cassette unit 0. The binary » 
containing user symbols, is produced on file 1 of cassette unit 1, 
and the listing is produced on file of cassette unit 2. 

1/E CT0:16 CT0:17 CT1:0 CT1:1 $LPT/L ) 

causes a two-pass assembly to be executed on input files CT0:16, 
CT0:17, CT1:0, and CT1:1 with a listing printed on the line printer. 
Error messages normally output to the $TTO are suppressed, and 
no binary file is produced. 

1 CT0:0/S CT0:0/P CT1:1/B ) 

causes a two-pass assembly to be performed on two files, both of 
which will be read from unit 0. The first file is a parameter list 
which will be read during the first pass only. After this parameter 
list is read, the pause message is output, and a new file is placed 
in cassette unit 0. The first file of this new reel is scanned for both 
pass 1 and pass 2 to complete the assembly, File 1 of unit 1 receives 
the binary output; no listing is produced. 
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Library File Editor 

Format: (LFE) A f listingname /Lf inputname f^f f /ft ] .. , f recordname f/Rf j ) 

(LFE) D inputname /I outputname/O recordname f recordname ... j ) 

(LFE) I f inputname / If outputname/Q f insertname f/ft | . . . f t ) 

f recordname /A insertname {/#]...]... ♦ ) 
frecordname/B insertname {/ft }. .. f... t ) 

(LFE) M outputname/ O inputname f/BH/H — f inputname f/BH/^H »»♦ ) 

(LFE) R inputname /I outputname /O recordname updatename \ ) 

f recordname updatename ] . . . j 

(LFE) T flistingname /Lj inputname j/B] {/ft ] ... f inputname j/Bj f/# j j... ) 
(LFE) X inputname/ I outputname /Q recordname ) 



where: inputname is the name of the input file which contains the re- 
locatable binaries or libraries; 

recordname is the name of the particular logical record to be 
analyzed, replaced, extracted, or before or after which in- 
sertions will occur-; 
listingname i s the name of the file used to output the analysis; 

outputname is the name of the file which will contain the new 
library; 

insertname is the name of the file containing relocatable bi- 
naries which are to be inserted; 

updatename is the name of the file which will replace the 
record. 

The parenthesized utility file name (LFE) indicates that LFE 
is a prompt issued by the utility when ready to accept a user 
command line and is not typed by the user. 

Purpose: To analyze the contents of a library file, to list titles in a library file, 

to merge libraries, to update libraries, to extract logical records from 
a library file, and to create new libraries. 

A library file (or library) Is comprised of a set of relocatable binary 
programs, called logical records. This collection of logical records 
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Library File Editor (Continued) 

Purpose: is denoted by a special beginning and ending block. Selection of any pro- 

(Continued) gram for loading is triggered by the occurrence of a global entry within 
the program that resolves an external declaration within a previously 
loaded program. (See the Library File Editor Manual, 093-000074, for 
a complete description of this utility. ) 

The key letters that may follow the prompt, LFE, and their meanings 

are: 



Record 

Names: 

Switches: 
Local: 



Key Letter 

A 

D 
I 

M 
R 
T 
X 



Command 

Analyze a set of library files and/or binaries, or analyze 
selected records in a library. 

Delete logical records from a library. 

Insert binaries into either a new or an existing library. 

Merge a library and binaries to form .a new library. 

Replace logical records in a library with new binaries. 

List titles in a set of libraries or binaries. 

Extract specific logical records from a library. 



Record names are those assigned to logical records by the .TITL 
pseudo-op. Only the first five characters are meaningful. 



/A 
/B 



/I 



/L 



After switch naming the logical recordname after which in- 
sertions will occur. ( Insert command. ) 

Before switch naming the logical recordname before which 
insertions will occur. (Insert command. ) 

or 

Binary record switch, indicating that the modified name 
represents a relocatable binary file rather than a library 
file. ( Analyze , merge , and titles commands.) 

_Input library file switch, specifying the file which contains 
the existing library. ( Delete , insert, replace and extract 
commands. ) 

Listing switch, indicating the file will be used to output the 
listing. ( Analyze and titles commands. ) 
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Library File Editor ( Continued ) 



Switches; 

Local; /O 

(Continued) 

/R 

/# 



Output library file switch naming the new library file, 
( Delete, insert, m erge, replace , and extract commands, ) 

Record switch. The logical recordname preceding the 
switch will be analyzed. ( Analyze command, ) 

Number switch, indicating how many binary records or 
libraries will be read. (Modifies $PTR or $TTR files 
only in analyze , insert , merge , and titles commands. ) 



Examples: A $LPT/L $PTR ABC/R CDE/R 

causes logical records ABC and CDE, in a library loaded on the 
high speed reader, to be analyzed. The analysis will be output 
on the line printer. 

D $PTR/I $PTP/0 ABC DEF 

causes logical records ABC and DEF to be deleted from the input 
library file, with the resulting library output on the high speed 
punch. . 

I $PTP/0 $PTR/3 

causes three relocatable binary records mounted on the high speed 
reader to be punched as a library file by the high speed punch. 

I $FTR/I $PTP/0 M/A $PTR 

causes a library to be updated with binaries. If the input library 
consists of logical records L, M, and N and the update record is 
Q, Q is inserted after record M. The result is an updated library 
consisting of records L, M, Q, and N. The new library is punched 
by the $PTP and the high speed reader is the single input device. 

M CTl;23/0 $PTR/3 $PTR/B/2 

causes three libraries to be input, then two binaries, forming a 
new library output as file number 23 on cassette drive 1. 

R $PTR/I $PTP/0 REC1 $PTR 

causes a library file, input on the high speed reader, to have one 
of its logical records (RE CI) replaced by an update input via the 
high speed reader. The new library will be punched on the high 

speed punch 
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Library File Editor (Continued) 

Examples: T $PTR 

(Continued) 

causes the titles of all logical records in the library file mounted 

in the high speed reader to be printed on the teletypewriter 

printer by default. 

X $PTR/I $PTP/0 ABC 

causes logical record ABC to be extracted from its library file, 
which is input on the high speed reader. Record ABC is a binary 
punched on the high speed punch. 
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SYSGEN 

Format: (SYSG) driver ^ . . driver n f. RDSFJ & CTB} outputfile /O trigger/T 

The parenthesized utility name (SYSG) is a prompt issued by SYSGEN 
when the utility is ready to accept a command line and is not part of 
the command line typed by the user. 

Purpose: SYSGEN generates triggers for use in configuring SOS utility programs, 

Each driver in the command line is an entry symbol for a program 
in one of the SOS libraries. (See Table 2-2. ) For each of these entry 
symbols included in the command line, an external normal reference 
to the program is included in the trigger. The trigger is entirely 
made up of these external normal references. 



Switches; 
Local: 



/O 
/T 



specifies the output file. 

specifies the preceding name as the title of the trigger. 
If this switch is omitted, the title "SGTRG" is given to the 
relocatable binary file produced. 



Errors: NOT ENOUGH ARGUMENTS * 

At least two arguments are needed, 

OUTPUT FILE WRITE PROTECTED, FILE: filename 

NO OUTPUTFILE SPECIFIED 

ILLEGAL SYMBOL NAME: symbolname 
Invalid character in the command line. 

FILE DOES NOT EXIST, FILE: filename 

UNEXPECTED SYSTEM ERROR 

Computer halts with the system error code in AC2 ( 
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SYSGEN (Continued) 

Example: . PTRD » FT PD , MTU4 , STTY » RDSI MTl:3/0 TRIG/T 

would cause the SYSGEN utility to output a trigger named TRIG 
containing external normal references to the driver routines for the 
high-speed paper tape reader, high-speed paper tape punch, mag- 
netic tape unit 4, teletypewriter keyboard and printer, and to the 
routine for the RDOS to SOS interface (. RDSI). 
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The FORTRAN IV Compiler (FORT) 
Format; (FORT) filename ... 

The parenthesized utility file name (FORT) indicates that FORT is 

a prompt issued by the utility when ready to accept a user command 
line and is not typed by the user. 

Purpose: To compile one or more FORTRAN source files, producing an output 

file suitable for input to the Extended Assembler, An output file and 
a listing file may optionally be specified in the command line using 
local switches described below. The command line must contain at 
least one input file name. 

If more than one input file name is specified, the message: 

TO CONTINUE, STRIKE ANY KEY 

is typed on the teletypewriter whenever one of the intermediate files 
has passed through the compiler. The next input file must be ready 
for opening when the user strikes the key. No other prompt messages 
are output for intermediate input files. 

Input files are compiled in the order in which they are specified in the 
command line. At the completion of each compilation, the prompt: 

FORT 

is again typed at the console. The prompt is reissued if no input file 
name is found in the command line. 

If the last specified input file does not contain an END statement, the 

message: 

END OF FILE 

Is typed at the console and the compiler must be restarted at location 
377. 



Switches: 
Local: 



/L causes listing to be directed to the file named. 

/O causes output to" be directed to the file named. 
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The FORTRAN IV Compiler (FORT) (Continued) 
/S 



Switches : 

Local: 



Errors; 



/X 



/n 



causes FORTRAN IV variables and statement numbers to 
be equivalenced to symbols acceptable to the assembler. 
(This switch must modify the output file name, ) 

causes compilation of statements with an X appearing in 
column 1 of the source line, (This switch must modify the 
output file name. ) 

compile the preceding input file n times. 



FATAL I/O ERROR xx 

This message is typed at the console if an unexpected system 
error occurs. xx_ is one of the two-digit error codes defined 
in the SOS User Parameter Tape, PARU.SR. 



Examples: $PTR/2 $PTP/0 $LPT/L ) 



causes FORTRAN IV to compile two source programs from the paper 
tape reader, outputting the assembler source code to the paper tape 
punch and a listing to the line printer. 

MT0:2 MT0:3 MTl:0/O) 

causes FORTRAN IV to compile source programs on files 2 and 3 
of magnetic tape unit 0, outputting the assembler source code to 
file of magnetic tape unit 1. 
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CHAPTER FOUR 

PROGRAM MODE OF SYSTEM COMMUNICATION 

SYSTEM C OMMAN D W ORDS 

Users communicate with the Stand-alone Operating System using system command 
words assembled into their programs. System command words and the mnemonic 
.SYSTM that must precede each command word are recognized as legal mnemonics 
by the SOS and RDOS Assemblers. * Appearance of the mnemonic . SYSTM in a 
program results in the assembling of a JSR @ 17 instruction which allows system 
communication through the main system entry address stored in page zero. For 
this reason, all assembly langugage programs Issuing system calls must be 
assembled using one of the standard DGC Assemblers in order to run under 
SOS. The system command word must be assembled as the word following 
. SYSTM. 

Once system action is complete, normal return is made to the second instruction 
after the command word. If an exceptional condition is detected, return is made 
to the first instruction following the system command word. 

The general form of a system call in a program is: 



. SYSTM 
command 
exceptional return 
normal return 



COMMAND WORD FORMAT 



STATUS IN AC2 

AG's & carry preserved or information 

returned as specified for the particular 

command. 



There are two basic command word formats: 
command n and command 



In the first format, n is a digit (from to 76) representing an I/O channel number 
or n specifies the CPU (77) as described in the next paragraph. The channel 
number n (0-76) indicates a logical link to an opened file. When no I/O channel is 
needed in command execution, the command word appears alone in the instruction. 
If the command requires arguments, these are passed in the accumulators. 



* DGC Extended Assembler Manual, 093-000040 
DGC Macro Assembler Manual, 093-000081 
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COMMAND WORD FORMAT (Continued) 

Any system command requiring a channel number n need not specify this number 
in the command itself. By specifying octal 77 (the device code of the CPU) as the 
channel number in the instruction^ the system will use instead the number passed 
in AC2. For example, the following instructions specify a write to channel 3: 

LDA 2, C3 
. SYSTM 
.WRS 77 
JSR ERR 



C3: 3 

(Standard SOS recognizes only SOS channels 0-37 unless the SOS Channel Number 
to Device Map has been expanded; see Appendix A). 

STATUS ON RETURN FROM SYSTEM 



Status of the accumulators upon return from the system is as follows: 

If the system returns no information as a result of the call, the carry and all accu- 
mulators except AC3 will be preserved. AC2 is used when an exceptional return 
is made to return a numeric error code. Error codes are listed by number at the 
end of this chapter and the applicable codes are listed for each command. 

AC3 is destroyed by a .SYSTM call (as it is by the use of JSR). On return from the 
system however, AC3 is loaded with the contents of memory location 16. This 
location is defined as a permanent symbol by the SOS Assembler and has the 
name USP (User Stack Pointer). A convenient method of saving AC 3 is to store it 
in USP before issuing the . SYSTM call. The system will load AC3 with the contents 
of USP upon return from the call. 

The SOS commands are shown in Table 4-1. They represent a subset of the RDOS 
system commands. All other RDOS system commands, including . RTN, result in 
an error return with error code: 

AC 2 Mnemonic Meaning 

2 ERICM Illegal system command 
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CLOSE 
DELAY 
EOPEN 
GCHAR 
GCHN 
GDAY 
GHRZ 
GTATR 
GTOD 
.IDEF 
.IRMV 
,MEM 
,MEMI 
, OPEN 
, PCHAR 
,RDL 
,RDS 
.RESET 
. ROPEN 
.SDAY 
.STOD 
.SYSI 
.WRL 
.WRS 



Close a file. 

Delay the execution of a task. 

Open a file for reading and writing. 

Get a character from the console. 

Get the number of a free channel. 

Get today's date. 

Examine the real time clock. 

Get the file attribute. 

Get the time of day. 

Identify a user device. 

Remove a user device. 

Determine available memory. 

Allocate an increment of memory using NMAX. 

Open a file for reading and writing. 

Output a character from the console. 

Read a line. 

Read sequential bytes. 

Close all files. 

Open a file for reading and writing. 

Set today's date. 

Set the time of day. 

Initialize SOS devices. 

Write a line. 

Write sequential bytes. 



Table 4-1. SOS Commands 
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BYTE POINTER 

One argument commonly passed in an accumulator is a byte pointer. A byte 
pointer contains the word address, in bits 0-14, which contains or will receive 
the byte. Bit 15 specifies which half (0 left; 1 right). Note that this is the reverse 
of the byte pointer as specified in "How to Use the Nova Computers, " To use the 
subroutine shown on page 2-21 of the manual, make the following change: 

Replace: MOV SZC 

With: MOV SNC 

The ".OPEN" command requires file names to be specified by means of a byte 
pointer to the name. The file name is stored as a character string. The string 
must consist of characters packed left to right (.TXTM 1) with the high order bit 
of each byte equal to zero. The string must have a terminating byte containing 
one of the following characters: null (000), form feed (014), carriage return (015), 
or space (040). 

For example, the word at location BPTR contains a byte pointer to a properly 
specified file name, $CDR: 

BPTR: 2*NAME 

.TXTM 1 
NAME: .TXT *$CDR* 

INITIALIZATION OF COMMUNICATIONS (.SYSI) 

The .SYSI command must be issued before any other SOS commands are used. It 
initializes all tables, clears each SOS device, restores NMAX to its value at load 
time, and enables interrupts from all devices. Additional .SYSI commands may 
be issued if the user wishes to clear devices on restart. 

The format of the command is: 



. SYSTM 
.SYSI 

error return 
normal return 



INITIALIZE SOS 

NEVER TAKEN 

AG's AND CARRY PRESERVED 
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FILE ATTRIBUTE COMMAND (GTATR) 

The file attribute command allows the user to determine the current attributes of 
a file or device. The bit settings of AGO and AC1 determine the file attributes and 

device characteristics respectively. 

This command obtains the attributes of a file and device characteristics. To obtain 
attributes, the file must be opened (see .OPEN). The number of the channel is 
given in the system command. The format of this command is: 

. SYSTM 
. GTATR n 
error return 
normal return 

Upon return, AGO contains the file attributes. The bit/attribute correspondence 
used in interpreting the bit configuration returned in AGO is shown below: 



Bit 

1B0 

1B1 



1B14 
1B15 



Mnemonic Meaning 

ATRP Device is read-protected. 

ATCHA Device is attribute -protected; has unsuppres sable 

device characteristics (e.g., the $TTI is attribute- 
protected; therefore it always has the DC KEY 
characteristic while it is open. ). 

ATPER Permanent file. All devices are permanent files. 

s 

ATWP Write -protected file. 
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FILE ATTRIBUTE COMMAND (.GTATR) (Continued) 

AC1 contains the device characteristics of the file. These do reflect the character- 
istic inhibit mask supplied when the file was opened. The bit/characteristics corre- 
spondence used in interpreting the bit configuration returned in AC1 as shown below: 

Meaning 

Directory device -i, e. , a data channel 
block transfer device. 
80- column device. 

Device requiring form feed on opening. 

Full word device (reads or writes more 

than a byte. ) 

Output device requiring line feeds after 

carriage returns. 

Input device requiring a parity check; 

output device requiring parity to be 

computed. 

Output device requiring a rubout after 

every tab. 

Output device requiring nulls after every 

form feed. 

A keyboard input device. 

A teletype output device. 

Output device without form feed hardware, 

Device requiring operator intervention. 

Output device without tabbing hardware. 

Output device requiring leader/trailer. 



Bit 


Mnemonic 


1B0 


DCDIR 


1B1 


DCC80 


1B3 


DCFFO 


1B4 


DCFWD 


1B6 


DC LAC 


1B7 


DCPCK 


1B8 


DCRAT 


1B9 


DCNAF 


1B10 


DCKEY 


1B11 


DCTO 


1B12 


DCCNF 


1B13 


DCIDI 


1B14 


DCCGN 


1B15 


DCCPO 



Possible errors resulting from a .GTATR command are; 



AC2 



15 



Mnemonic 

ERFNO 
ERFOP 



Meaning 

Illegal channel number. 

Attempt to get attributes of an unopened 

file. 
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INPUT /Ul.TPLT COMMANDS 

All I/O is handled by system I/O commands. These commands require a channel 
number (0-"o) 5 " to be given in the second field of the command word. If the channel 
number is 77, then AC2 must contain the desired channel number. A channel is 
linked to a particular file or device by means of a , OPEN, , EOPEN, or . ROPEN 

command. The association between a file and a channel number can be broken by 
using the . CLOSE command. All currently open files can be closed by using the 
. RESET command. 

The system provides two basic modes of reading and writing files. The first mode 
is line mode, where data read or written is assumed to consist of ASCII character 
strings terminated by either carriage returns, form feed characters, or nulls. 
Position within a file Is implicit from the last call. That is, file data is processed 
line by line in sequence from the beginning of the file to its end. 

In line mode, the system handles all device dependent editing at the device driver 
level. For example, line feeds are ignored on paper tape input devices and are 
supplied after carriage returns to all paper tape output devices. Furthermore, 
reading and writing never require byte counts, since reading continues until a 
terminator is read and writing proceeds until a terminator is written. The line 
mode commands are .RDL and .WRL. 

The second mode is unedited sequential mode . In this mode, data is transmitted 
exactly as read from the file or device. No assumption is made by the system as to 
the nature of this information. Thus this mode would always be used for processing 
binary files. This mode requires the user program to specify byte counts necessary 
to satisfy a particular read or write request. As with line mode, position within a 
file is determined by the position at the end of the last sequential mode call, and the 
first read or write occurred at the beginning of the file after it was first opened. 
The sequential mode commands are . RDS and . WRS. 



^Standard SOS recognizes only SOS channels 0-37 unless the SOS Channel Number 

to Device Map has been expanded; see Appendix A. 
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Open a File (» OPEN, , EOPEN, or , RQPEN) 

Before other I/O commands can be used, a file must be linked to a SOS Channel 
Number, , OPEN links a file with a channel number and makes the file available 
to any user for both reading and writing, * . EOPEN and , ROPEN will achieve exactly 
the same results and have been included for the sake of RDOS compatibility. 

When running with RDOS -SOS, AGO must contain a byte pointer to the file name. 
When running with STANDARD SOS, AGO never contains an argument - unless the 
file being opened is a cassette or magnetic tape unit. In that case AGO contains the 
file number, 

A characteristic mask must be passed in AC1. (If AC1 contains 0, no character- 
istics are inhibited. Also, if the device is attribute protected, the mask is ignored. ) 
For every bit set hi this word, the corresponding device characteristic (as defined 
previously in the discussion of the .GTATR command) is inhibited. The character- 
istics will be inhibited for the duration of the . OPEN. For example, if the user has 
an ASCII tape without parity to be read from the paper tape reader, he may inhibit 
parity checking by the following (when running under RDOS -SOS): 





LDA 


0, READR 




LDA 


1, MASK 




. SYSTM 






. OPEN 


3 


READR: 


.+1*2 






.TXT 


*$PTR* 


MASK: 


DCPCK 





;PARITY CHARACTERISTIC 



In general, the user will wish to preserve all device characteristics as defined by 
the system. This can be accomplished by a SUB 1, 1 instruction before the system 
call instruction. 

The . OPEN command results in the initialization of the control table for the device, 
the output of leader on paper tape output devices, or a prompt message for input 
devices requiring user intervention: "LOAD filename, STRIKE ANY KEY". 



*When running under Standard SOS, this link is already established; the user need 
only pass the physical SOS Channel Number according to the procedures given here. 
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ERFNO 


1 


ERFNM 


12 


ERDLE 


21 


ERUFT 


31 


ERSEL 



Open a File (.OPEN , .EOPEN , or .RQPEN) (Continued) 

The format of the , OPEN command is: 

. SYSTM 

. OPEN n ; OPEN CHANNEL n 

error return 
normal return 

Possible errors resulting from .OPEN commands are; 

AC2 Mnemonic Meaning 

Illegal channel number. 

Illegal file name. 

File does not exist. 

Attempt to use channel already in use. 

Unit improperly selected. 

Get the Number of a Free Channel (. GCHN) 

This call enables the user to obtain the number of a channel that is currently unused, 
if any, so that a file may be opened on this channel via one of the file open calls. 
. GCHN does not open a file on a free channel; it merely indicates a channel that is 
free at the moment. RDOS-SOS returns the lowest available channel number in the 
range 0-76. This command is illegal when running under Standard SOS. 

The format of this call is: 

. SYSTM 
. GCHN 
error return 
normal return 

Upon a normal return, the information is returned in AC2: 

AC2 - Free channel number 

One possible error return may occur. 

AC2 Mnemonic Meaning 

21 ERUFT No channels are free. 
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Close a File (.CLOSE) 

After use, files may be closed to insure an orderly ending sequence. The channel 
number is then available for other I/O. The format of the .CLOSE command is; 

. SYSTM 

. CLOSE n ;CLOSE CHANNEL n 

error return 
normal return 

If the file closed requires trailer (such as the high speed punch) it will be output on 
the .CLOSE. 

Possible errors resulting from a .CLOSE command are; 

AC2 Mnemonic Meaning 

Illegal number. 

Attempt to reference a channel not in use. 






ERFNO 


15 


ERFOP 


Close all Files (.RESET) 



This command causes all currently open files to be closed. The command also 
insures that any partially filled buffers are written before the file is closed. The 
format of the . RESET command is; 

. SYSTM 
.RESET 
error return 
normal return 

The error return from this command is never taken. 

Read a Line (. RDL) 

This command causes an ASCII line, written with even parity, to be read. AGO 
must contain a byte pointer to the starting byte address within the user area into 
which the line will be read. This area should be 133 bytes long. 

Reading will terminate normally after transmitting either a carriage return, form 
feed, or null to the user, Reading will terminate abnormally after transmission of 
132 (decimal) characters without detecting a carriage return, form feed, or null 
as the 133 r ^ character, upon detection of a parity error, or upon an end-of-file 
(CTRL Z). 
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Mead a Line (. RDL.) (Continued) 

In all cases, the read byte count including the carriage return, form feed, or null 
will be returned in AC1, If the read is terminated because of a parity error, the 
character having the incorrect parity will be stored with the parity bit cleared as 
the last character read. The byte pointer to the character in error can always be 
computed as: 

C(AC0)*+C(AC1)-1 

The format of the . RDL command is: 



. SYSTM 
.RDLn 
error return 
normal return 



;READ FROM CHANNEL n 



Possible errors resulting from a .RDL command are: 



AC2 


Mnemonic 





ERFNO 


3 


ERICD 


6 


EREOF 


7 


ERRPR 


15 


ERFOP 


22 


ERLLI 


24 


ERPAR 


30 


ERFIL 



Meaning 

Illegal channel number. 
Illegal command for device. 
End of file. 

Attempt to read a read-protected file. 
Attempt to reference a file not opened. 
"Line limit (132 characters) exceeded. 
Parity error. 
File read error. 



* C(AC ) means "contents of AC ' 
n n 
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R'-ari Scqixmial (.RDS) 

Sequential mode transmits data exactly as read from the file, AGO must contain a 
byte pointer to the starting byte address within the user area into which the data 
will be read, and AC1 must contain the number of bytes to be read. The format of 

the , RDS command is: 

. SYSTM 

. RDS n ;READ FROiVl CHANNEL n 

error return 

normal return 

Possible errors resulting from a , RDS command are: 

AC2 Mnemonic Meaning 

Illegal channel number. 

Illegal command for device. 

End of file. 

Attempt to read a read-protected file. 

Attempt to reference a file not opened. 

File read error. 

Upon detection of an end-of-file, the partial read count will be returned in AC1. 

Use of the Card Reader ($CDR) in . RDL and . RDS Commands 

When using $CDR (card reader) as an input device, the end of file condition of a 
. RDL will occur only if a special end of file code is detected in column 1 of a card. 
This code is all rows punched. It can be punched on a 029 keypunch by multipunching 
"+", "-", and "0" through "9". Note that a Hollerith to ASCII translation only occurs 
if a .RDL has been requested. The translation assumes 029 keypunch codes. A 
. RDL is terminated upon the first trailing blank (which is translated as a carriage 
return). If all 80 columns are data, a carriage return is appended as the eighty- 
first character. If an illegal character is detected, a back slash is substituted and 
the line is terminated. A table of Hollerith - ASCII translation is given on the follow 
Ing two pages. 

If a . RDS is given, the card is read in image binary. Each two bytes will be used 
to store a single column. 






ERFNO 


3 


ERICD 


6 


EREOF 


7 


ERRPR 


15 


ERFOP 


30 


ERFIL 



4-12 



CHAR. 


CARD CODE 


ASCII CODE 



CHAR, 



CARD CODE 



ASCII CODE 



NUL 


12-0-9-8-1 


000 


SOH 


12-9-1 


001 


STX 


12-9-2 


002 


ETX 


12-9-3 


003 


EOT 


9-7 


004 


ENQ 


0-9-8-5 


005 


ACK 


0-9-8-6 


006 


BEL 


0-9-8-7 


007 


m 


11-9-6 


010 


HT 


12-9-5 


011 


LF 


0-9-5 


012 


VT 


12-9-8-3 


013 


FF 


12-9-8-4 


014 


CR 


12-9-8-5 


015 


SO 


12-9-8-6 


016 


SI 


12-9-8-7 


017 


DLE 


12-11-9-8-1 


020 


DC1 


11-9-1 


021 


DC2 


11-9-2 


022 


DC3 


11-9-3 


023 


DC4 


4-8-9 


024 


NAK 


9-8-5 


025 


SYN 


9-2 


026 


ETB 


0-9-6 


027 


CAN 


1 1-9-8 


030 


EM 


1 1-9-8-1 


031 


SUB 


9-8-7 


032 


ESC 


0-9-7 


033 


FS 


1 1-9-8-4 


034 


GS 


11-9-8-5 


035 


RS 


11-9-8-6 


036 


US 


11-9-8-7 


037 



ACE 


NO PUNCHES 


040 


i 


12-8-7 


041 


» 


8-7 


042 


# 


8-3 


043 


$ 


11-8-3 


044 


% 


0-8-4 


045 


& 


12 


046 


• 


8-5 


04 7« 


( 


12-8-5 


050 


) 


11-8-5 


051 


# 


11-8-4 


052 


+ 


12-8-6 


053 


» 


0-8-3 


054 


- 


11 


055 


. 


12-8-3 


056 


/ 


0-1 


057 








060 


1 


1 


061 


2 


2 


062 


3 


3 


063 


4 


4 


064 


5 


5 


065 


6 


6 


066 


7 


7 


067 


8 


8 


070 


9 


9 


071 


: 


8-2 


072 


> 


11-8-6 


073 


< 


12-8-4 


074 


— 


8-6 


075 


> 


0-8-6 


076 


? 


0-8-7 


077 



Hollerith- ASCII Translation Table 
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CHAR. j 


CARD CODE 


ASCII CODE 


§ 


8-4 


100 


A 


12-1 


101 


B 


12-2 


102 


C 


12-3 


103 


D 


12-4 


104 


E 


12-5 


105 


F 


12-6 


106 


G 


12-7 


107 


H 


12-8 


110 


I 


12-9 


111 


J 


11-1 


112 


K 


11-2 


113 


L 


11-3 


114 


M 


11-4 


115 


N 


11-5 


116 





11-6 


117 


P 


11-7 


120 


Q 


11-8 


121 


R 


11-9 


122 


S 


0-2 


123 


T 


0-3 


124 


U 


0-4 


125 


V 


0-5 


126 


W 


0-6 


127 


X 


0-7 


130 


Y 


0-8 


131 


Z 


0-9 


132 


[ 


12-8-2 


133 


\ 


0-8-2 


134 


3 


11-8-2 


135 


— i or 1 


11-8-7 


136 


— or — 


0-8-5 


137 



CHAR. 


CARD CODE 


ASCII CODE 



a 
b 
c 
d 

e 
f 

g 
h 

i 

j 
k 

1 

m 

n 

o 

P 

q 

r 
s 
t 
•i 

V 

w 

X 

y 

z 



DEL 



8-1 

12-0-1 

12-0-2 

12-0-3 

12-0-4 

12-0-5 

12-0-6 

12-0-7 

12-0-8 

12-0-9 

12-11-1 

12-11-2 

12-11-3 

12-11-4 

12-11-5 

12-11-6 

12-11-7 

12-11-8 

12-11-9 

11-0-2 

11-0-3 

11-0-4 

11-0-5 

11-0-6 

11-0-7 

11-0-8 

11-0-9 

12-0 

12-11 

11-0 

11-0-1 

12-9-7 



140 
141 
142 
143 
144 
145 
146 
147 
150 
151 
152 
153 
154 
155 
156 
157 
160 
161 
162 
163 
164 
165 
166 
167 
170 
171 
172 
173 
174 
175 
176 
177 



Hollerith - ASCII Translation Table (Continued) 
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Use of the Card Reader (SCDR) in . RDL and . RDS Commands (Continued) 

The packing is done as follows: 



Byte: 
Column No, : 

Bit: 

Contents: 







— 1 

12 11 





1 


2 


2 *- 

3 4 5 6 7 8 9 


1 


2 


3 4 5 


6 


7 


8 


9 10 11 12 13 14 15 








Odd 


d 


d 


d 


d d d d d d d 



The "dV will be 1 for every column punched. End -of-card in a read sequential is 
signified by a byte pair containing the word 100000. The specified byte count must 
be an even number. 

Write a Line (.WRL) 

This command presumes an ASCII file. AGO must contain a byte pointer to the 
starting byte address within the user area from which characters will be written. 
Writing will terminate normally upon writing a null, a carriage return, or a form 
feed, and abnormally after transmission of 132 (decimal) characters without 
detection of a carriage return, a null, or a form feed as the 133rd character. In 
all cases, AC1 will contain, upon termination, the number of bytes written from the 
user area to complete the request. The termination of a write line upon a null 
permits formatting output without forcing a carriage return. 

The format of the .WRL command Is: 



. SYSTM 

• WRL £ 
error return 

normal return 



:WRITE TO CHANNEL n 
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Write a Line (. WRL) (Continued) 

Possible errors resulting from the .WRL command are- 

Meaning 



AC2 


Mnemonic 





ERFNO 


3 


ERICD 


10 


ERWPR 


15 


ERFOP 


22 


ERLLI 


Write 


Sequential (.WRS) 



Illegal channel number. 
Illegal command for device. 
Attempt to write a write -protected file. 
Attempt to reference a file not opened. 
Line limit (132 characters) exceeded. 



This command writes data exactly as it is in the user area. A CO must contain a 
byte pointer to the starting address of the data within the user area, and AC1 must 
contain the number of bytes to be written. The format of the .WRS command is: 



. SYSTM 
.WRS n 
error return 
normal return 



:WRITE TO CHANNEL n 



Possible errors resulting from a .WRS command are: 
AC2 Mnemonic Meaning 






ERFNO 


3 


ERICD 


10 


ERWPR 


15 


ERFOP 



Illegal channel number. 
Illegal command for device. 
Attempt to write a write -protected file, 
Attempt to reference a file not opened. 



4-16 



CONSOLE COMMANDS 

Buffered transfer of single characters between a program console and ACO is handled 
by the commands. GCHAR and , PCHAR. These commands reference $TTI/$TTO» 
No channel number is required for these commands, and the console is always avail- 
able to them without requiring an open command. 

Get a Character (.GCHAR) 

This command returns a character typed from the console in ACO. The character 
is right -adjusted in ACO with bits 0-8 cleared. No channel is required: the $TTI 
is always used as input for this command. The format of the .GCHAR command is; 

. SYSTM 
. GCHAR 
error return 
normal return 

No error return is possible from this command-, if no character is currently in the 
TTI input buffer, the caller waits. 

Put a Character (. PCHAR) 

This command transmits a character in ACO, bits 9-15, to the console. No 
channel is required: the $TTO is always used as output for this command. The 
format of the . PCHAR command is : 

. SYSTM 
.PCHAR 
error return 

normal return 

No error return is possible from this command. 
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MEMORY CQy\:.V.T; S 

Upon completion of a relocatable load, the Stand-alone Operating System resides in 
lower memory, among various user or system programs comprising the load 

module. 

Memory then looks essentially like this: 



user program 



SOS 



system program 



user program 



topi of memory - HMA (highest memory address 
available) 

NMAX (first location available above loaded programs) 



bottom of memory 



The highest memory address available (HMA) is usually the first word below the 
Binary or Core Image Loader. 

K a user symbol table has been loaded at the high end of user memory, HMA will 
be the first word below the user symbol table. (The loader, by default, moves the 
symbol table down so that the bottom of the table coincides with the first location 
not loaded into by the program. ) 

Determine Available Memory (.MEM) 

This command returns the current value of NMAX in AC1 and the value of HMA in 
AGO. HMA represents the location immediately below either the bottom of the 
Binary or Core Image Loader or the end of the user symbol table. A SUB 1, ins true- 
tion determines the amount of additional memory available to the user program. The 
format of the .MEM command is: 

. SYSTM 

.MEM 

error return 
:"■ n\- ;ii r>. mr;: 

There are no error returns from this command. 
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Change NMAX (. MEMI) 

This command allows the user to increase or decrease the value of NMAX. The 
increment or decrement (in two's complement) is passed in AGO, The command 
causes the value of NMAX to be updated in the UST (in USTNM) and the new NMAX 
to be returned in AC1. The format of this call is: 

» SYSTM 
.MEMI 
error return 
normal return 

NMAX will not be changed if the new value of NMAX would be equal to or higher than 
HMA. No check is made as to whether or not the user decreases NMAX below its 
original value (as determined at relocatable load time) nor, if his symbol table 

resides in upper memory, whether he increases NMAX above the bottom of his 
symbol table. 

Whenever a user program requires memory space above the loaded program, 
. MEMI should be invoked first to allocate the number of words needed. The 
allocated memory space may be used by programs for buffers, user stacks, 
temporary storage, etc. 

There is one error resulting from a .MEMI command; 

AC2 Mnemonic Meaning 

26 ERMEM Attempt to allocate more memory than 

available. 

CLOCK/CALENDAR COMMANDS 

Four commands are provided to permit the system to keep track of the time of day 
and the current date. Dates are referenced as month/day/year. The time of day 
is given using a 24-hour clock. In addition, the , GHRZ command provides the 
frequency of the Real Time Clock, and the . DELAY suspends the execution of a 

program. 



NOTE; All Clock /Calendar commands except . GHRZ are treated 
as illegal commands if a Real Time Clock Driver is absent 
from trie load module. 
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Get the Time of Day (, GTQD) 

This command requests the system to pass the current time in hours, minutes, and 
seconds to the caller, (To be meaningful, this time must have been initialized by 
the ".STOD" command; see below.) TTie time will be returned as follows: 

AGO - Seconds: AC1 - Minutes: AC2 - Hours (using a 24-hour clock) 

The format of this co-i — anc' is: 

. SYSTM 
.GTOD 
error return 
normal return 

No error return is possible. 

Set the Time of Day (, STOD) 

This command permits the setting of the system clock to a specific hour, minute, 
and second. The user passes the initial values as follows: 

AGO - Seconds: AC1 - Minutes: AC2 - Hours (using a 24 -hour clock) 

The format of this command is: 

. SYSTM 
,STOD 
error return 
normal return 

A possible error message is: 

AC2 Mnemonic Meaning 

41 ERTIM Illegal time of day. 

Get Today's Date (. GDAY) 

Ibis command requests the system to return the number of the current month, day, 
and year. (To be meaningful, this date must have been initialized by the ". SDAY" 
command; see below. ) The month is returned in AC1, the day in AGO, and the 
current year (less 1968) is returned in AC2. The format of the . GDAY command is: 
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Get Today* s Date ( jGDAY) (Continued) 

. SYSTM 
.GDAY 
error return 
•-lori^al rc'ir'i 

No error return is possible. 

Set Today's Date (. SPAY) 

This command permits the setting of the system calendar to a specific date. The 
user passes the number of the month in AC1 (January is month number 1 ), the 
number of the day within the month in AGO and the number of the current year -- 
less 1968--in AC2. This is the date that is unconditionally returned to the .GDAY 
command. It is not incremented when the time of day clock overflows. The format 
of the . SDAY command is: 

. SYSTM 
.SDAY 
error return 
normal return 

One possible error message is: 

AC2 Mnemonic Meaning 

41 ERTIM Illegal day, month, or year. 

Delay the Execution of a Task (.DELAY) 

The calling program is suspended for the number of real-time clock pulses indicated 
by AC1. The real-time clock frequency was specified at load time (see .GHRZ). 

The format of this command is: 

AC1 - Number of RTC pulses 

, SYSTM 
.DELAY 
error return 
normal return 

The error return is never taken. A "JMP . " instruction within the system is 
executed until this period elapses. 
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y ' -•:•-' "-' i"^- •:'-'■■ " y^-. - T. ■ ■ Tl r->. C'k '- ' . r ' ; R 7 > 

This system call permits the user to examine the Real Time Clock frequency, The 
frequency is returned in AGO, in the following manner; 

ACQ Meaning 

There is no Real Time Clock in the system. 

1 Frequency is 10 HZ. 

2 Frequency is 100 HZ. 

3 Frequency is 1000 HZ. 

4 Frequency is 60 HZ (line frequency) 

5 Frequency is 50 HZ ( line frequency) 

The format of this call is: 

. SYSTM 
.GHRZ 
error return 
normal return 

The error return is never taken. 

-SERVICING USER INTERRUPTS 

There are several considerations which must be made by any user wishing to service 
device interrupt requests. See Appendix A - Adding User Supplied Device Handlers. 

Identify a User Interrupt (. ID E F) 

In order to introduce to the system those devices (not identified at LOAD time) 
whose interrupts the system is to recognize, the system call. IDEF must be issued. 
This adds an entry to the SOS Internal Search List (See Appendix A). AGO contains 
the device code of the new device. AC1 contains the address of the new device's 
DCT. If the device code that is passed is 77g, then AC1 contains the address to 
which the system passes control whenever it detects a power-fail interrupt. The 
format of the command is: 

.SYSTM 

.IDEF 

error return 
normal re tut:;: 
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Identify a User Interrupt (Continued) 

Possible error messages are: - ■ 

AC2 Mnemonic Meaning 

36 ERDXM Illegal device code(>77g). Device code 77 g . is re- 

served for power monitor/auto restart option, 

45 ERIBS Interrupt device code in use. 

Remove User Interrupt Servicing Program (JRMV) 

To prevent the system's recognition of user interrupts which have been previously 
identified by the . IDEF command, the . IRMV command must be issued. ACO 
contains the user device code which is to be removed from the system's recognition. 
The format of the . IRMV command is; 

. SYSTM 
. IRMV 
error return 
normal return 

One possible error message may be given: 

AC2 Mnemonic Meaning 

36 ERDNM Illegal device code (>77 ). 
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ERROR MESSAGES 



Code 



Mnemonic 



ERFNO 



ERFNM 



Meaning 

Illegal channel number. 



Illegal file Name. 



Applicable 

Commands 

. OPEN 
, EOPEN 
. ROPEN 
, GTATR 
.RDL 
.RDS 
.WRL 
,WRS 

.OPEN 
. EOPEN 
. ROPEN 



10 



12 



15 



ERICM 
ERICD 



EREOF 



ERR PR 



ERWPR 



ERDLE 



ERFOP 



Illegal system command. 
Illegal command for device. 



End of file. 



.RDL 
.RDS 
.WRL 
.WRS 

.RDL 
.RDS 



Attempt to read a read-protected . RDL 
file. • RDS 

Attempt to write a write -protected .WRL 
file. -WRS 

Attempt to reference a non- existent . OPEN 
file . EOPEN 

. ROPEN 



Attempt to reference a file not 
opened 



. GTATR 

.CLOSE 

.RDL 

.RDS 

.WRL 

.WRS 
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ERROR MESSAGES (Continued) 









Applicable 


Code 


Mnemonic 


Meaning 


Commands 


21 


ERUFT 


Attempt to use channel already 
in use. 


.OPEN 
.EOPEN 
. ROPEN 
. GCHN 


22 


ERLLI 


Line limit exceeded on read or 


.RDL 






write line. 


.WRL 


24 


ERPAR 


Parity error on read line. 


.RDL 


26 


ERMEM 


Attempt to allocate more memory 
than available. 


. MEMI 


30 


ERFIL 


File read error. 


.RDL 
.RDS 


31 

| ) 


ERSEL 


Unit not properly selected. 


. OPEN 

.EOPEN 
. ROPEN 


36 


ERDNM 


Illegal device code (> 77 g) 


.IRMV 
.IDEF 


41 


ERTIM 


Illegal time or date. 


.SDAY 
.STOD 



45 



ERIBS 



Interrupt device code in use, 



.IDEF 
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DEVICE RESPONSE TO SOS COMMANDS 

This section describes the function performed by the SOS I/O commands, as 
applied to each of the devices supported by DGC. 

TTI1 



OPEN 

CLOSE 

RDS 



Device is initialized. 
Device is reinitialized. 

The specified bytes are read into the user area from the device un- 
edited. 



.RDL 



$PLT 

. OPEN 
.CLOSE 
.WRS 
.WRL 

TTOl 



The ASCII string is read into the user area from the device. The 
input stream is echoed on the TTOl. A rubout character deletes 
the previous input character and causes a back arrow to be echoed. 
The shift L character causes the entire input string to be deleted. 
CTRL Z causes an END OF FILE return. Line feeds are ignored. 



Device is initialized. 

Device is reinitialized after outstanding I/O is complete. 
The specified bytes are output to the device, unedited. 
Illegal command to this device. 



.OPEN 
.CLOSE 
.WRS 
.WRL 



Device is initialized. 

Device is reinitialized after outstanding I/O is complete. 

The specified bytes are output to the device unedited. 

The ASCII string is output to the device with simulated tabbing, a 

line feed inserted after carriage return, and nulls inserted after 

form feeds. 



$TTP 



. OPEN 
.CLOSE 



WRS 
WRL 



Device is initialized; leader is punched. 

Device is reinitialized after outstanding I/O is complete; trailer is 

punched. 

The specified bytes are output to the device, unedited. 
The ASCII string is output to the device with rubout characters inserted 
after tabs, a line feed inserted after carriage returns, and nulls in- 
serted after form feeds. 
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DEVICE RESPONSE TO SOS COMMANDS (Continued) 

$CDR 



.OPEN 

.CLOSE 
.RDS 



.RDL 



$TTO 

.OPEN 
.CLOSE 
.WRS 
.WRL 



$TTI 



.OPEN 

.CLOSE 

.RDS 

.RDL 



Device is initialized; a prompt message is written and a response is 
necessary for the program to continue. 
Device is reinitialized. 

The specified bytes are read into the user area from the device, un- 
edited. Each pair of bytes read represents one full column of the 
card. Bits 4-7 of the first byte represent card rows 12, 11,0, and 1 
respectively. 

Bits 0-7 of the second byte represent card rows 2-9 respectively. 
A one in bit of the first byte of a pair indicates end of card. No 
other meaningful data is included in this byte pair. 

The 80-character ASCII string is read into the user area from the 
device. If the characteristic DCC80 was suppressed on the . OPEN, 
then 72 columns are read. The translation from Hollerith is per- 
formed in the card reader driver. A 12-11-0-1-2-3-4-5-6-7-8-9 
punch causes end of file. The byte count returned to the user re- 
flects the last non-blank character on the card. See page 4-12. 



Device is initialized. 

Device is reinitialized after outstanding I/O is complete. 

The specified bytes are output to the device unedited. 

The ASCII string is output to the device with simulated tabbing , a 

line feed Inserted after carriage return, and nulls inserted after 

form feeds. 



Device Is initialized. 
Device is reinitialized. 

The specified bytes are read into the user area .from the device, 

unedited. 

The ASCII string is read Into the user area from the device. The 

input stream is echoed on the $TTO. A rubout character deletes the 

previous input character and causes a back arrow to be echoed. The 

shift L character causes the entire input string to be deleted. CTRL Z 

causes an END OF FILE return. Line feeds are ignored. 
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DEVICE RESPONSE TO SQS COMMANDS (C ontinued ) 

$TTR 

. OPEN Device is initialized: a prompt message is written and a response 

is necessary for the program to continue. 
.CLOSE Device is reinitialized. 

. RDS The specified bytes are read into the user area from the device, 

unedited. 
. RDL The ASCII string is read into the user area from the device. Rubouts 

and line feeds are ignored. 

CTA (See also Chapter 2, SOS Cassette and Magnetic Tape Files. ) 

. OPEN The specified file is located on the tape reel, and the read/write 

head positioned to the file mark preceding. 
.CLOSE Device is reinitialized. Following write operations, the last partial 

block is output to the file(padded with nulls if necessary) and two end 

of file marks are written, 
. RDS The specified bytes are read into the user area from the file, unedited, 

. RDL The ASCII string is read into the user area from the file. Rubouts 

and line feeds are ignored. 
.WRS The specified bytes are output to the file, unedited. 

.WRL The ASCII string is output to the file. 

$LPT 



. OPEN 
.CLOSE 

.WRS 
.WRL 



NOTE; 



Device is initialized. 

Device is reinitialized; a form feed character is output. 

The specified bytes are output to the device, unedited. 

The ASCII string is output to the device with simulated tabbing, and 

line feeds are inserted after carriage returns. 

If the external symbol . LPTD triggered the loading of the LINE 
PRINTER Driver, then all characters after the 80th are ignored on 
.WRL commands. If the symbol . L132 was the trigger, then all 
132 characters will be printed. 
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DEVICE RESPONSE TO SOS COMMANDS (Continued) 
$PTR 

. OPEN Device is initialized; a prompt message is written and a response is 

necessary for the program to continue, 
.CLOSE Device is reinitialized. 

. RDS The specified bytes are read into the user area from the device, 

unedited. 
. RDL The ASCII string is read into the user area from the device. Rubouts 

and line feeds are ignored. 



$PTP 

.OPEN 
.CLOSE 

. WRS 
.WRL 



Device is initialized; leader is punched. 

Device is reinitialized after outstanding I/O is complete; trailer is 

punched. 

The specified bytes are output to the device, unedited. 

The ASCII string is output to the device with rubouts inserted after 

tabs, a line feed after a carriage return, and nulls after a form feed. 



MTA (See Chapter 2, SOS Cassette and Magnetic Tape Files.) 

. OPEN The specified file is located on the tape reel, and the read/write 

head positioned to the file mark preceding. 

.CLOSE Device is reinitialized. Following write operations, the last partial 

block is output to the file(padded with nulls if necessary) and two end 
of files marks are written. 

. RDS The specified bytes are read into the user area from the file, un- 

edited. 

. RDL The ASCII string is read into the user area from the file. Rubouts 

and line feeds are ignored. 

.WRS The specified bytes are output to the file, unedited. 

.WRL The ASCII string is output to the file. 
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USER STATUS TABLE 

The User Status Table (UST) is a 22 octal word table which records all information 

pertinent to the execution of an entire program level. This table is located at 
addresses 0400 through 0421* inclusive and has the following structure: 



address 



label 



contents 



400 
401 
402 
403 
404 
405 
406 
407 
410 
411 
412 
413 
414 
415 
416 
417 
420 
421 



USTPC Program counter 

USTZM ZMAX 

USTSS Start of Symbol Table (SST) 

USTES End of Symbol Table (EST) 

USTNM NMAX after runtime . ME Mis 

USTSA Starting address of program 

USTDA Debugger address; -1 if not loaded 

USTHU Highest load address 

USTCS FORTRAN common area size 

USTIT Interrupt address (Control A keyboard character) 

USTBR Break address (Control C keyboard character) 

USTCH Number of channels and TCBs (unused by SOS) 

USTCT Current TCB pointer (unused by SOS) 

USTAC Start of active TCB chain (unused by SOS) 

USTFC Start of free TCB chain (unused by SOS) 

USTIN initial Start of NREL code (INMAX) 

USTOD Overlay directory address (unused by SOS) 

USTSV FORTRAN State Variable Save routine pointer 

(unused by SOS) 



Location 400 - USTPC is the program counter. 



Location 401 - USTZM points to the first available location in page zero for page 
zero relocatable code. 

Location 402 and 403 - USTSS and USTES point to the start and end of the symbol 
table respectively. The loader sets 402 and 403 to if the debugger is not loaded. 

Location 404 - USTNM contains NMAX. The loader sets the pointer to the first 
free location for further loading or for allocation of temporary storage at run time. 



♦Location 12, USTP always points to the start of the UST. 
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USER STATUS TABLE (Continued) 

Location 405 - USTSA points to the program starting address, specified by the . END 
statement, If no starting address is specified by any loaded program, -1 is stored 
in 405, If several programs specify starting addresses, USTSA contains the address 
specified in the last program loaded. -Location 377 contains a JMP @2» which transfers 
control to a routine in SOS which performs a . SYSI and then branches to the program 
starting address. Therefore, the user can conveniently restart his program at 377, 
assuming that he has specified a starting address, ) 

Location 406 - USTDA points to the starting address of the debugger, or if the 
debugger is not loaded, 406 contains -1. 

Location 407 - USTHU is set to the value of NMAX at the termination of loading. 
This word is never changed by the operating system during program execution. It 
is used to reset USTNM whenever a . SYSI is executed. 

Location 410 - USTCS contains the size of the FORTRAN unlabeled common area. 

Location 411 and 412 - USTIT and USTBR are the interrupt address and break 
address respectively. Both are initialized to -1. Whenever the location contains 
or -1, the corresponding interrupt is ignored by the system. To receive control 
after CTRL A interrupts, USTIT must be changed by the user program to the 
desired transfer address. The Core Image Loader sets USTBR to the beginning 
address of the Core Image Loader whenever it loads a save file into core. The 
user program may then modify USTBR to either point to its own CTRL C break 
address or to disable CTRL C interrupts. When control is passed to the USTIT 
address, machine interrupts are enabled; when control is passed to the USTBR address f 
machine interrupts are disabled . 

Location 413-416 - Locations that are used by RDOS and RTOS. 

Location 417 - USTIN contains the address of the start of normally relocatable code 
(440 g ). 

Location 420 - Location used by RDOS. 

Location 421 - USTSV points to the address of the FORTRAN state variable save 
routine. 
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CHAPTER 5 
CONFIGURING SOS UTILITY PROGRAMS 

The process of configuring a utility program generally consists of the following: 

1. Producing a trigger which specifies the desired I/O support, 

2. Performing a relocatable Toad of the trigger, the appropriate SOS 
Libraries, and the relocatable binary (RB) version of the utility 
program. 

Ihese procedures apply to all SOS utilities except the assembler. The assembler 
program requires an execution pass on the DGC command definitions in order to 
expand its permanent symbol table appropriately after it has been loaded. 

SUPPLIED TAPES 



The paper tapes listed below comprise die entire SOS package. TTiese tape lists 
are separated according to those that are supplied to all users and those that are 
supplied to paper tape, cassette tape, and magnetic tape users respectively. 

The absolute binary (AB) versions of the programs listed below are preconfigured 
with conventional paper tape support mat is, high speed paper tape reader and 
punch, full teletype (keyboard, printer, reader, and punch) and 80 column line 
printer. In addition to these devices, the absolute binary programs supplied to 
cassette users include three cassette units (0, 1, and 2); absolute binaries supplied 
to magnetic tape users include three magnetic tape units (0, 1, and 2). 

The paper tapes that are supplied to all SOS users are the following: 

Name Tape Number 

SOS Library 099-000010 

SOS Text Editor (RB) - utility 089-000104 

SOS Extended Assembler (RB) - utility 089-000106 

SOS Library File Editor (RB) - utility 089-000081 

SOS SYSGEN (RB) - utility 089-000122 

RDOS User Parameters (PYIU'i ' !9n-Qf )Q.sv3 

SOS System Parameters (PARA) 090-000498 

SOS User Application Parameters (PARUA) 090-000889 

SOS Debug 089-000167 
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SUPPLIED TAPES (Continued) 



Name •> 

Extended Assembler Command Definitions 
DGC Basic Instructions 
Floating Point Interpreter 

Operating System Instructions 



Tape Number 

090-001482 
090-001483 
090-001484 



The additional paper tapes that are supplied to users without cassette or magnetic 
support are the following: 



Name 

SOS Extended Assembler (AB) - utility 

SOS Library File Editor (AB) - utility 

SOS SYSGEN (AB) - utility 

Stand -alone Extended Relocatable Loader (AB) 

Relocatable Binary Punch Program (RB) 



Tape Number 

091-000069 
091-000057 
091-000070 
091-000038 
089-000080 



The additional paper tapes that are supplied to users with cassette drives are the 
following: 



Name 

SOS Cassette Library 

Cassette Core Image Loader /Writer (AB) - utility 
SOS Relocatable Loader (RB) - utility 
SOS Command Line Interpreter (RB) - utility 
SOS SYSGEN with cassette support (AB) - utility 
SOS CLI with cassette support (AB) - utility 
SOS Relocatable Loader with cassette support (AB) - 

utility 



Tape Number 



099- 
091- 
089- 
089- 
091- 
091- 



000041 
000067 
000120 
000121 
000071 
000072 



091-000073 



The additional paper tapes that are supplied to users with magnet ic tape drives 
are the following: 



Name 

SOS Magnetic Tape Library 

Magnetic Tape Core Image Loader/Writer (AB) - utility 
SOS Relocatable Loader (RB) - utility 
SOS Command Line Interpreter (RB) - utility 
SOS SYSGEN with mag tape support (AB) - utility 
SOS CLI with mag tape support (AB) - utility 
SOS Relocatable Loader with mag tape support (AB) - 

utility 



Tape Number 

099-000042 
091-000068 
089-000120 

089-000121 
091-000074 
091-000075 

091-000076 
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SUPPLIED TAPES (Continued) 

Available to cassette users at extra cost are cassette reels 070-000002 and 
070-000008. Available to magnetic tape users at extra cost is magnetic tape reel 
071-000004. The programs in save (SV) file format on these tapes are preconfigured 
in the same manner as the corresponding absolute binaries listed above. In the 
subsequent procedures to produce a tailored master reel, the library and relocatable 
binary files on these tapes may be substituted for the corresponding paper tapes as 
input to the SOS Relocatable Loader. 

The contents of these reels are as follows: 

CASSETTES (Model #3235) 

070-000002: 

Core Image Loader/ Writer (SV) File 

Relocatable Loader (SV) File 1 

Command Line Interpreter (SV) File 2 

Text Editor (SV) File 3 

Assembler (SV) File 4 

Library File Editor (SV) File 5 

SYSGEN(SV) File6 

071-000003: 

Cassette Library 

SOS Library 

Command Line Interpreter (RB) 

Text Editor (RB) 

Assembler (RB) 

Relocatable Loader (RB) 

Library File Editor (RB) 

SYSGEN (RB) 

Extended Assembler Command Definitions: 

Nova Basic Instructions 

Floating Point Interpreter 

Operating Systems 
RDOS User Parameters 
SOS Stand-alone Parameters 
SOS User Application Parameters 



File 


File 1 


File 2 


File 3 


File 4 


File 5 


File 6 


File 7 


File 8 


File 9 


File 10 


File 11 


File 12 


File 13 
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SUPPLIED TAPES (Continued) 

MAGNETIC TAPE (Model #3236) 



071-000004: 



Core Image Loader /Writer (SV) File 

Relocatable Loader (SV) File l 

Command Line Interpreter (SV) File 2 

Text Editor (SV) File 3 

Assembler (SV) File 4 

Library File Editor (SV) File 5 

SYSGEN (SV) File 6 

SOS Magnetic Tape Library File 7 

SOS Library File 8 

Command Line Interpreter (RB) File 9 

Text Editor (RB) File 10 

Assembler (RB) File 11 

Relocatable Loader (RB) File 12 

Library File Editor (RB) File 13 

SYSGEN (RB) File 14 
Extended Assembler Command Defininitions: 

Nova Basic Instructions File 15 

Floating Point Interpreter File 16 

Operating Systems File 17 

RDOS User Parameters File 18 

SOS Stand-alone Parameters File 19 

SOS User Application Parameters File 20 

The relocatable binary versions of the SOS Utility programs can be used to produce 
executable versions of these programs configured with arbitrary I/O support. This 
facility permits users to eliminate all undesired device drivers and to reclaim the 
core space taken up by them. 

The source files ( 090 series tapes ) contained in the package are used to: 

1. Add permanent symbols to user generated SOS Assemblers. 

2. Define equivalences in certain user programs; the various parameter 
tapes provide these facilities. 

The remainder of this chapter describes in detail the procedures for generating 
SOS Utility Programs that are tailored to the user's I/O configuration. 
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PRODUCING A TRIGGER 

Triggers are produced by the SYSG program. This program accepts a command line, 
which contains device driver ENTRY symbols, from the console device. It outputs 
a relocatable binary file (the trigger) which is comprised of EXTERNAL NORMAL 
symbols corresponding to the named device drivers. These EXTERNAL NORMALS 
cause the selection or "triggering" of the desired routines for loading when the 
trigger precedes the SOS Libraries as input to the relocatable loader. 

The first step to produce a trigger is to load and start the SYSG program. This can 
be done by using the binary loader to load an absolute binary SYSG paper tape 
(091-000070, 091-000071, or 091-000074). SYSG can be loaded from the cassette 
or magnetic tape using the Core Image Loader /Writer. 

When the SYSGEN program is started, it, outputs the prompt message; 

SYSG 

and waits for the user to type a command line. This command line has the following 
format: 

(SYSG) driver l ... driver . RDSI £ .CTB} [ .RTC1} output-file /O t) 
f triggername /T } ) n 



where: 



driver: is an entry symbol in the desired device driver routine. Table 2-2 lists 
all possible symbols 

. CTB is the optional Command Table Builder. This symbol must be specified 
for triggers to be used in configuring the SOS Assembler, the SOS 
Relocatable Loader, the SYSGEN program, and the SOS FORTRAN IV 
Compiler. 

. RTC1 causes the loading of a 10 Hz Real Time Clock Driver from the SOS 
Library. This symbol must be specified for the CLI. 

output -file is the name of the file /device to which the user wishes the trigger 
to be output. This name must be followed by the /O switch. 

trigger -name is the optional title (.TITL) of the trigger. If this name is omitted 
the trigger will be named SGTRG, by default. If the name is present, 
it must be followed by the /T switch. 
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producing :. trig* nr ..commute.) 

An example of the use of the SYSG program is shown below. This command line 
causes a trigger to be generated at the high speed paper tape punch to provide 
support for a small teletype, high speed reader and punch. Command Table Builder, 
and cassette units and 1: 

(SYSG) . PTRD . PTPD , STTY SPTP/G » RDSI . CTB . CTU1 ) 

The trigger produced will have the title SGTRG since no trigger title was specified. 

After the trigger has been output, the SYSGEN program will again type its prompt 
(SYSG) and wait for another command. If more than one utility program is to be 
configured, requiring different triggers, it is most convenient to generate all the 
necessary triggers before overwriting the SYSGEN program in core. 

A discussion of the SYSGEN program, including its associated error messages, is 
included in Chapter 3. 

PROCEDURES FOR PAPER TAPE UTILITIES 

Configuring Utilities except the Assembler 

The following is a step by step description for configuring all SOS Paper Tape Utilities 
except the assembler. The end result is an absolute binary paper tape of the utility. 
Before starting this procedure, the trigger to be used should be generated on paper 
tape. Each typed command in this procedure must be terminated by a carriage 
return. 

1. Using the binary loader, load the Extended Relocatable Loader (tape 091-000038). 

2. Mount the trigger in the teletype reader and type 1, or in the high-speed paper 
tape reader and type 2, 

3. Mount the SOS Library (099-000010) in the teletype reader and type 1, or in the 
high-speed paper tape reader and type 2. If the trigger specifies support for cassette 
or magnetic tape drives, perform this process first for the SOS Cassette Library 
(099-000041) or the SOS Magnetic Tape Library (099-000042), and then the SOS Library. 

4. Mount the relocatable binary version of the program to be configured in the 
teletype reader and type 1, or in the high-speed paper tape reader and type 2. 

5. Type 5 and note the value of NMAX output by the relocatable loader on the tele- 
type; this number will be used in Step 12. 
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PROCEDURES FOR PAPER TAPE UTILITIES (Continued) 
Configuring Utilities except the Assembler (Continued) 

6. Mount the relocatable binary punch program (089-000080) on the teletype reader 
and type 1, or on the high-speed paper tape reader and type 2. 

7. Type 6 and note the value of RBFP output by the relocatable loader on the teletype; 
this number will be used in Step 9. 

8. Type 8 to terminate the loading process. 

9. Enter RBFP (from Step 7) into the data switches on the computer console, press 
RESET and then press START. 

10. Type OH for output on the teletype punch or 1H for output on the high-speed 
paper tape punch. 

11. Type 1, nmaxP where nmax is the value of NMAX noted in Step 5. 

12. Type 377E, to specify a starting address for the program. 
Configuring the Assembler 

The following is a step by step description for configuring the SOS Assembler. It 
is similar to the preceding procedures; however before an absolute binary tape is 
punched, the DGC command definitions are added to the assembler permanent 

symbol table. 

1. Using the binary loader, load the Extended Relocatable Loader (tape 091-000038). 

2. Mount the trigger in the teletype reader and type 1, or in the high-speed paper 
tape reader and type 2. 

3. Mount the SOS Library(099-000010) in the teletype reader and type 1, or in the 
high-speed paper tape reader and type 2. If the trigger specifies support for cassette 
or magnetic tape drives, perform this process first for the SOS Cassette Library 
(099-000041) or the SOS Magnetic Tape Library (099-000042), respectively, and then 
mount the SOS Library, 

4. Mount the relocatable binary version of the SOS Extended Assembler (089-000106) 
in the teletype reader and type 1, or in the high-speed paper tape reader and type 2. 
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PROCEDURES FOR PAPER TAPE UTILITIES (Continued) 

Configuring the Assembler (Continued) 

5, Enter 016500 8 in the data switches on the computer console and type 3. 

6 Mount the relocatable binary punch program (089-000080) on the teletype 
reader and type 1, or on the high-speed paper tape reader and type 2. 

7. Type 6 and note the value of RBFP output by the relocatable loader on the 
teletype; this number will be used in Step 13. 

8. Type 8 to terminate the loading process. 

9. Press CONTINUE on the computer console to start the assembler. 

10 Mount the extended assembler command definitions tape (090-001482) in the 
teletype reader and type $TTR/3, or in the high-speed paper tape reader and 
type $PTR/3. 

11. Mount the remaining tapes (090-001483 and 090-001484) when they are requested 
by the prompt message and strike any console key as requested. 

12. When the assembler halts, examine AGO and note its contents (NMAX); this 
value will be used in step 15. 

13. Enter RBFP (from step 7) into the data switches on the computer console, press 
RESET, and then press START. 

14. Type OH for output on the teletype punch or 1H for output on the high-speed 
paper tape punch, 

15. Type 1, nmax P where nmax is the value of NMAX noted in step 11. 

16. Type 377E to specify a starting address for the program. 
PRODUCING A MASTER REEL 

The following procedure details the necessary steps to configure SOS utility programs 
and at the same time produce a master cassette or magnetic tape reel. The 
assumption is made that only one cassette or magnetic tape drive is available and 
that all programs input to the Relocatable Loader are on paper tape. The high speed 
paper tape reader is assumed to be the input device for these tapes. 
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PRODUCING A MASTER REEL (Continued) 

Before starting this procedure, the triggers should have been generated on paper 
tapes. When the cassette or magnetic tape reel that is required tor this procedure 
has been mounted, the cassette should have its file protect tab in place and the 
magnetic tape should contain a write permit ring, so that files may be written on 
them. Each typed command in this procedure must be terminated by a carriage 
return. The master reel generated on unit need never be removed from that unit 
during the following procedures. 



1. CILW: 



2. RLDR: 



Using the binary loader, load and start the absolute binary version of 
the Core Image LoaderAVriter (091-000067 for cassette; 091-000068 
for magnetic tape). When started this program will output the following 
message to the console device; 

LOAD UNIT 0: STRIKE ANY KEY 

Place the cassette or magnetic tape reel that is to become the master 
on unit and depress any key on the console keyboard. This program 
will write a Core Image Loader/Writer (CILW) to file of unit 0. When 
the loader has been successfully written the message, 

LOADER INSTALLED 

"is printed at the console and the tape is rewound. (This program may 
be used to install additional loaders at this point. After the program 
HALTs, the user may depress the CONTINUE switch on the master 
console. The above message is again printed and the user may then 
change cassette or mag tape reels or unit assignments and continue 
the above procedures). 

The binary loader remains in high core. Using this loader, load the 
absolute binary version of the SOS Relocatable Loader (091-000073 for 
cassette; 091-000076 for magnetic tape). This program outputs the 
prompt message (RLDR) to the console device; respond with the com- 
mand line: 

CT0:1/S SFTR/4 (for cassette) 
MT0:1/S $FTR/4 (for magnetic tape) 
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PRODUCING A MASTER REEL (Continued) 

2. RLDR: (Continued) 

If the teletype reader Is used, substitute $TTR for $PTR. As the 
relocatable loader requests them, mount the following paper tapes 

in order: 

1. The trigger to be used for the Relocatable Loader. 

2. The SOS Cassette Library (099-000041) for cassette or 
the SOS Magnetic Tape Library (099-000042) for mag- 
netic tape. 

3. The SOS Library (099-000010) 

4. The relocatable binary version of the SOS Relocatable 
Loader (089-000120) 

The loader will produce a core image of the tailored Relocatable 
Loader on file 1 of the master reel, type OK, and HALT when finished. 
This version of the loader is now usable for the remaining procedures. 

It will typically need to be re-loaded via the CILW, but in this one case 
it is already present in core. Hence to restart the loader, merely 
depress the CONTINUE switch on the master console. 



3. CLI; 



After the Relocatable Loader outputs the prompt message (RLDR) to 
the console, respond with the command line: 

CT0:2/S $PTR/4 (for cassette) 
MT0:2/S $PTR/4 (for magnetic tape) 

If the teletype reader is used, substitute $TTR for $PTR. As the 
relocatable loader requests them, mount the following paper tapes in 
order: 

1. The trigger to be used for the Command Line Interpreter. 

2. The SOS Cassette Library (099-000041) for cassette or the 
SOS Magnetic Tape Library (099-000042) for magnetic tape, 

3. The SOS Library (099-000010) 

4. The relocatable binary version of the SOS Command Line 
Interpreter (089-000121). 

The loader will produce a core image or save file version of this 
utility program on the designated file of the master reel. It will type 
OK and HALT when finished. 
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PRODUCING A MASTER REEL (C ontinued ) 

4, Restore RLDR; 

The Relocatable Loader -must be restored to core using the CILW, 
Restart the CILW by setting the address of the last location in core 
into the data switches on the master console. Depress RESET, and 
then START, (An alternate procedure to start this program is 'to 
manually rewind unit 0, make the unit ready, depress RESET on the 
master console, and then depress PROGRAM LOAD switch. Data 
switches 0, 11, and 14 must be set to ones before depressing PROGRAM 
LOAD. This procedure must be used after step 3 because the CILW 
has not yet overwritten the absolute binary loader in high core). 

The CILW is invoked and types its prompt message: 

# 

to the console device. Respond to this prompt with the command line: 
0:1 

The user-configured version of the SOS Relocatable Loader will be 
returned to core. 

5. EDIT: 

Repeat step 3 making the following substitutions: 

1. CT0:3/S or MT0.-3/S instead of CT0;2 or MT0:2 respec- 
tively in the Relocatable Loader command line. 

2. The trigger for the SOS Text Editor instead of the trigger 
for the CLI. 

3. The relocatable binary version of the SOS Text Editor 
(089-000104) instead of that of the CLI. 

6. Restore RLDR; 

Repeat step 4 to restart the Relocatable Loader. 



5-11 



PRODUCING A MASTER REEL (Continued) 

7. ASM: 

Repeat step 3 making the following substitutions: 

1. CT0:4/S or MT0:4/S instead of CTO: 2/S or MIX): 2/S respectively 
in the Relocatable Loader command line. 

2. The trigger for the SOS Assembler instead of the trigger for the 
CLI. 

3. The relocatable binary version of the SOS Assembler 
(089-000106) instead of that of the CLI. 



8. ASM: 



Depress the CONTINUE switch on the master console to start the 
assembler. 

9. ASM: 

Respond to the assembler prompt message (ASM) with the following 
command line: 

$PTR/3 (or $TTR if the teletype reader is used) 

If the Floating Point Instruction definitions are not desired, respond 
with: 

$PTR/2 or $TTR/2 . 

10. ASM: 

Mount each command definition tape as it is requested (by the 

LOAD J 1 " 1 ? , STRIKE ANY KEY message) and depress any console key. 

$PTR 

These tapes are (in order): 

Nova Basic Instructions (090-001482) 

*Floating Point Interpreter (090-001483) 

Operating System Instructions (090-001484) 

*only use if these command definitions are desired for permanent 
symbols. 
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PRODUCING A MASTER REEL (Continued) 



ASM: (Continued) 



11, ASM; 



The assembler will perform a one pass assembly on these source files 
and then HALT, 



EXAMINE (using the master console switches) the contents of AGO and 
note for use in step 12, 

12. CILW: 

Start the Core Image Writer by setting the address of the next to last 
location in core into the data switches on the master console, pressing 
RESET, and then START. Respond to this program's prompt message 
(#) with: 

0:4 

Respond to the next prompt message (NMAX:) with the octal value noted 
in step 11. The Core Image Writer will rewrite a core image of the 
assembler to file 4 of the master reel. This copy contains the assemblers 
permanent symbols in the symbol table. It will type OK and HALT when 
finished. 

13. Restore RLDR: 

Repeat step 4 to restart the Relocatable Loader. 



14. LFE: 



Repeat step 3 making the following substitutions: 

1. CTO: 5/S or MTO: 5/S instead of CT0:.-2/S or MTO: 2/S respectively 
in the Relocatable Loader command line. 

2. The trigger for the SOS Library File Editor (LFE) instead of 
the trigger for the CLI. 

3. The relocatable binary version of the SOS LFE (089-000081) 
instead of that of the CLI. 
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PRODUCING A MASTER REEL (Continued) 

15. Restore RLDR: 

Repeat step 4 to restart the Relocatable Loader, 

16. SYSG: 

Repeat step 3 making the following substitutions: 

1. CTO: 5/S or MTO: 6/S instead of CTO: 2/S or MTO: 2/S respectively 
in the Relocatable Loader command line. 

2. The trigger for the SOS SYSGEN program instead of the trigger 
for the CLI. 

3. The relocatable binary version of SOS SYSGEN (089-000122) 
instead of that of the CLI. 

This completes the generation of a master reel. 
CONFIGURING A SOS FORTRAN IV COMPILER 

The procedures for configuring a FORTRAN IV compiler are identical to the 
previous procedures. The additional tapes that are required are the relocatable 
binary version of the FORTRAN IV Compiler (089-000161) and the SOS FORTRAN 
Interface (089-000041). TTie input order of the tapes to the appropriate relocatable 
loader is the following: 

1. FORTRAN Compiler trigger (see Producing a Trigger). 

2. SOS Cassette Library, SOSCT. LB (099-000041) for cassette systems. 

3. SOS Magnetic Tape Library, SOSMT. LB (099-000042) for magnetic tape 

systems. 

4. SOS Library, SOS. LB (099-000010). 

5. SOS FORTRAN Interface, SOSFI. RB (089-000041). 

6. FORTRAN IV Compiler, FORT. RB (089-000161). 
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CONFIGURING A SOS FORTRAN IV COMPILER (Continued) 

For magnetic tape and cassette systems, the core image (save) version of this 
program may be placed onto the master reel as file 7, If it occupies this position 
on a master reel, then it may be read into core via the CLI command: 

BOOT FORT 
See Chapter 3, BOOT command for a further description. 
Example 

Figure 5-1 shows the $TTO output as a result of the procedures to generate a 
master reel. The triggers were generated on paper tape. The trigger titles 
which are printed reflect the three versions of triggers necessary to configure 
all SOS utilities: 



TRIG1 



TRIG2 



TRIG3 



used for the RLDR, ASM,SYSGEN, and FORTRAN IV Compiler; 
Contains . RDSI, .CTB, and all desired device driver symbols, 

used for the CLI; Contains . RDSI, . RTCI, and all desired 
device driver symbols. 

used for the Text Editor and LFE; Contains .RDSI and all desired 
device driver symbols. 



The other device driver symbols used for this example are: 



.CDRD 

.STTY 

.TTI1 

.LI 32 

.PTRD 

.PTPD 

.xMTUl 



card reader 

small teletype 

second teletype 

132 column line printer 

high speed paper tape reader 

high speed paper tape punch 

two magnetic tape units 



In this example, a master magnetic tape reel is created on unit 0. 
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LOAD UNIT 01 STRIKE ANY KEY 



Step 1 



LOADER I K STALLED 



RLDR MT0: 
LOAD SPTR 

TRIG 1 
LOAD SPTR 
LOAD SPTR 
LOAD SPTR 

RLDR 
XN .GDTE 
XN .SDTE 
XN .U04D 
XN .U0 3D 
XN .U02D 
XN .U01D 
XN .U00D 
XN .CTU7 
XN .CTU6 
XN .CTU5 
XN . CTU4 
XN .CTU3 
XN .CTU2 
XN .CTU1 
XN . CTU0 
XN .MTU7 
XN .MTU6 
XN .MTU5 
XN .MTU4 
XN .MTU 3 
XN .MTU2 
XN .CTAD 
XN .OPPP 
XN .OPTP 
XN .PLTD 
XN .RTCD 
XN .DLY 
XN . STDD 
XN .GTDD 
NMAX 
2 MAX 
CSZE 
EST 
SST 



I/S SPTR/4 
> STRIKE AMY 



KEY 



, STRIKE ANY KEY 
, STRIKE ANY KEY 
j STRIKE ANY KEY 

005617 

0056 15 

005651 

005650 

005647 

005646 

005645 

005704 

005703 

005702 

005701 

005700 

005677 

005676 

005675 

005674 

005673 

005672 

00567 1 

005670 

005667 

007504 

007502 

005644 

005653 

006750 

005613 

005607 

0056 1.1 

01466 1 

000302 



Step 2 

RLDR Trigger 

SOSMXLB 
SOS. LB 
RLDR.RB 



N 



> 



List of unresolved EXTERNAL 
NORMALS put out by the SOS 
Relocatable Loader. These are 
routines and drivers in the SOS 
Library that are unused and 
hence not included in the load 
module. 



J 



OK 



Figure 5-1. Sample $TTO Dialogue during Generation of a Master Reel 
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RLDR MT0j 
LOAD SPTR 

TRIG2 
LOAD SPTR 
LOAD SPTR 
LOAD SPTR 

SOSCL 
KM .U04D 
XN .U03D 
XN .U02D 
XM .U01D 

xm .U00D 

XN .CTU7 

XN .CTU6 

XN .CTU5 

XN . CTU4 

XN .CTU3 

XN . CTU2 

xn .ctui 

XN -CTU0 
XN .MTU7 

XN .MTU6 

XN .MTU 5 

XN .MTU4 

XN .MTU 3 

XN .MTU2 

XN .CTAD 

XN .OPPP 

XN .OPTP 

XN .PLTD 

NMAX 

EM AX 

CSZE 

EST 

SST 



2/5 SPTR/4 

j STRIKE ANY KEY 

j STRIKE ANY KEY 
* STRIKE ANY KEY 
> STRIKE ANY KEY 

005470 

005467 

005466 

005465 

005464 

005523 

005522 

005521 

005520 

0055.17 

0055.16 

005515 

0055J4 

005513 

0055.12 

00551 1 

005510 

005507 

005506 

007 323 

007321 

005463 

005472 

017600 

000223 



Step 3 

■ GLI Trigger 

SOSMT.LB 
•SDS.LB 

■ CLI. RB 



OK 



Figure 5-1. Sample $TTO Dialogue during Generation of a Master Reel (Continued) 
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Step 4 



#0:1 

RLDR MT0:3/S SPTR/4 -* — Step 5 

LOAD SPTR, STRIKE ANY KEY 
TRIG 3 "* Editor Trigger 

LOAD SPTR, STRIKE ANY KEY -. — SOSMT, LB 

LOAD SPTR, STRIKE ANY KEY -* — SOS. LB 

LOAD $PTR, STRIKE ANY KEY ~« EDIT RB 

EDIT 

XN .GDTE 085236 

XN . SDTE 0052 34 

XN .U04D 005270 

XN .U03D 005267 

XN .U02D 005266 

XN .U0 1D 005265 

XN .U00D 005264 

XN .CTU7 0053 2 3 

XN .CTU6 005 3 22 

XN .CTU5 00532 1 

XN .CTU4 005320 
XN .CTU3 0053 17 

XN .CTU2 005 316 

XN .CTU1 005315 

XN .CTU0 0053.14 

XN .MTU7 0053 13 

XN .MTU6 0053 12 

XN .MTU5 0053.11 

XN .MTU4 00 53 10 

XN .MTU 3 005 307 

XN .MTU2 005306 

XN .CTAD 007 j 23 

XN .OPPP 007 12 1 

XN .OPTP 005263 

XN .PLTD 005272 

XN .RTCD 006 367 

XN .DLY 0052 32 

XN . STDD 005226 

XN .GTDD 005230 

NMAX 012555 

2MAX 0002 35 

CS2E 

EST 

SST 



OK 



Figure 5 -1. Sample $TTO Dialogue during Generation of a Master Reel (Continued) 
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# 0J 1 

RLDR KT0:4/S SPTR/4 

LOAD 5PTR, STRIKE AMY KEY 

TRIG 1 
LOAD SPTR, STRIKE ANY KEY 
LOAD SPTRj STRIKE ANY KEY 
LOAD SPTR, STRIKE ANY KEY 

ASM 

0056 17 

0056 15 
005651 
005650 
005647 
085646 
005645 

0057 04 
0057S3 
005702 
0057 01 
0057 00 
005677 
005676 
005675 
005674 
005673 
00 56 7 2 
005671 
005670 
005667 
007 5 04 
007502 
005644 
005653 
006750 
0056 13 
005607 
0056 1 1 
016601 
000364 



• Step 6 
-Step 7 

-ASM Trigger 

SOSMT.LB 

• SOS. LB 

■ ASM, RB 



xn 

XN 

XN 

XN 

XN 

XN 

XN 

XN 

XN 

XN 

XN 

XN 

XN 

XN 

XN 

XN 

XN 

XN 

XN 

XN 

XN 

XN 

XN 

XN 

XN 

XN 

XN 

XN 

:tj 



• GDTE 
.SDTE 
.U04D 
.U03D 
.U02D 
.U01D 
.U00D 
.CTU7 
.CTU6 

• CTU5 
.CTU4 
-CTU3 
.CTU2 
. CTU 1 
.CTU0 
.MTU 7 
.MTU6 
.MTU 5 
.MTU4 
.MTU 3 
.MTU 2 
.CTAD 
.OP^P 
.OPTP 
.PLTD 
• RTCD 
.DLY 
.STDD 
.GTDD 

NHAX 

2 MAX 

CS0E 

EST 

SST 



ok 



Figure 5-1. Sample $TTO Dialogue during Generation of a Master Reel (Continued) 
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LOAD $PT1 
LOAD SPT 1 



5TP.IKE AMY KEY 



17703 



# 0:4 
NMAX l 

OK 

# 0:1 

RLDF MT2: 
LOAD SPTH 
TRI3 3 

LOAD SPTR 
LOAD SPTH 
LOAD SPTR 

STLFE 
XN .GDTE 
XM .SDTE 
.U04D. 
.U03D 
.U02D 
.U01D 
.U80D 
.CTU7 
. CTU6 
.CTU5 
. CTU4 
.CTU3 
.CTU2 
.CTU1 
.CTU0 
.MTU7 
.MTU6 
.MTU 5 
.MTU 4 
.MTU 3 
.MTU 2 
.CTAD 
.OPPP 
.OPTP 
.PLTD 
.PTCD 
• PLY 
.STDD 
.GTDD 
NMAX 
EM AX 
CS2E 
EST 
SST 



XM 
XN 
XN 
XM 
XN 
XN 
XN 
XM 
XN 
XN 
XN 
XN 
XN 
XN 
XN 
XN 
XN 
XN 
XN 
XN 
XN 
XN 
XN 
XN 
XN 
XN 
XN 



5/5 .SPTR/4 

, STRIKE ANY 

* STRIKE ANY 

CTT3T1/TP AMV 
9 D I ri 1 Jv XL. Hi "J J 

, STRIKE ANY 

005236 
005234 
005270 
005267 
005266 
005265 
-805264 
005323 
005322 
005321 
005320 
005317 
0053 16 
005315 
0053J4 
0053 13 
005312 
80531 1 
005310 
005307 
005306 
007 123 
007 121 
005263 
005272 
006 367 
005232 
005226 
005230 
0147 16 
000260 



KEY 



KEY 
KEY 



•Step 8 

•Step 9 (No floating point instructions. ) 

-Step 10 

■Step 11 (EXAiMINE AGO. ) 

-Step 12 

-Value recorded in Step 11. 

-Step J 3 
■ Step 14 



LFE Trigger 

SOSMT. LB 
SOS. LB 
LFE. RB 



OK 

Figure 5-1. Sample $TTO Dialogue during Generation of a Master Reel (Continued) 
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# 0j 1 •* — -Step 15 

ELDE MT0:6/S SPTE/4 ** Step 16 

LOAD SPTR, STRIKE ANY KEY ^ SYSG Trigger 

TRIG 1 

LOAD SPTRj STRIKE ANY KEY -* SOSMT, LB 

LOAD SPTrU STRIKE ANY KEY' •*■ ■ SOS. LB 

LOAD SPTR., STRIKE ANY KEY -« SYSG. RB 

SYSG 

XN .GDTE 9056 17 

XN .SDTE 3056 15 

XN .U04D 00 5651 

XN .U03D 005658 

XN .U02D 005647 

XN .U01D 005646 

XN .U00D 005645 

XN .CTU7 0057 04 

XN .CTU6 0057 03 

XN .CTU5 0057 02 

XN .CTU4 0057 01 

XN .CTU3 005700 

XN .CTU2 005677 

XN .CTU1 00567 6 

XN .CTU0 00567 5 

XI\J .MTU7 005674 

XN .MTU6 00567 3 

XN .MTU5 00567 2 

XN .MTU4 00 56 7 1 

XN .MTU 3 00567 

XN .MTU2 005667 

XN .CTAD 007 5 04 

XN .OPPP 007 5 02 

XN .OPTP 005644 

XN .PLTD 005653 

XN .RTCD 0067 50 

XN .DLY 0056 13 

XN .STDD 0056 07 

XN .GTDD 0056 1 1 

NHAX 11041 

ZMAX 000 135 
CS2E 
EST 
SST 



OK 



Figure 5-1. Sample $TTO Dialogue during Generation cf a Master Reel (Continued) 
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APPENDIX A 
ADDING A USER -SUPPLIED DEVICE HANDLER TO SOS 



INTRODUCTION 

This appendix is intended to ease the task of adding a special device handler to die 
SOS Library. There are effectively two types of devices that may be incorporated 
into SOS. 

1. A type of device that requires interrupt dispatching provided by the system 
but which can otherwise be controlled outside of the system. By regulating 
the dispatching of interrupts, the system selectively controls the interrupt! - 
bility of that device's interrupt service routine. Thus, certain devices 
may interrupt other devices under system control. Devices which have 

the property of requiring this interrupt service only from the system are 
hereafter referred to as Level One devices. 

2. A type of device that requires the interrupt service described above, as 
well as base (non -interrupt) level control by the system. These devices 
are the most common; all SOS devices that perform I/O through system 
commands (. WRL, .RDL, .WRS, . RDS) fall into this category. These 

devices are hereafter referred to as Level Two devices. 

Devices of both levels are currently supported by drivers in the SOS Library. The 
Real Time Clock is a Level One device; the high speed punch, $PTP» is a Level 
Two device. The clock requires interrupt service only from the system. The punch 
requires interrupt service as well as base level control in order to perform line and 
sequential output. Furthermore the interrupt service is necessary to synchronize 
the base level control. (It should be noted that an I/O device, as well as an interrupt 
only device, may be added to the system with Level One Support. L^vel One merely 
precludes the control of the device through system I/O commands; however, the 
user may wish to control the starting and stopping of a device through his own sub- 
routines while relying on the system only to dispatch interrupts to him appropriately. ) 

TTie remainder of this appendix fully details the considerations to be made for adding 
device handlers to SOS. There are a number of existing links in SOS that facilitate 
these procedures (see page- A -7). No source code within the SOS Library need 
ever be modified to add devices. However, several tables within the SOS Library 
may require changes. The modified tables need only be introduced to SOS at load 
time. Thus the procedures are in all cases reduced to the addition of new relocatable 
binary programs to a load nrvLk' which ire hides the SOS Libra ri.cs. 
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SOS DEVICE HANDLING STRATEGY 

In order to appreciate the procedures for incorporating device handlers into 
SOS, it is useful to understand the strategy that the system employs to control 
devices. This strategy can be analyzed in terms of its applicability to Level 
One and then Level Two devices. 

Consider first Level One devices which must be serviced at the interrupt level 
only. (As previously mentioned, all system devices have this property, ) 

When an interrupt is detected by the system, the interrupted machine state 
must be saved. Next, the interrupting device must be identified in order to 
determine where to dispatch control to service this interrupt. Before control 
passes to the interrupt service routine however, the system must determine 
which devices may interrupt this routine and then appropriately enable that set 
of devices. The interrupt service routine may then perform any number of 
functions, ranging from several machine instructions to several hundred. (See 
SOS Interrupt Handling, page A -22) The one common function of all interrupt 
service routines is to clear the interrupting device. When the interrupt service 
routine completes Its functions, it returns control to the system interrupt dis- 
patcher. This routine now must restore the previously saved machine state and 
return control to the program counter at the time of the interrupt. 

This restored machine state, to which control is returned, may be either a base 
level program or another interrupt service routine that was interrupted. In 
the latter case, the above procedures beginning at the interrupted point would be 
repeated and the machine state finally restored would be that at the time that the 
former device interrupted. In this manner, interrupts are stacked and selectively 
processed by the system. 

There are two variables which determine the relative priority with which individual 
interrupting devices will be serviced by the system: 

1. The SOS Interrupt Search List which determines the order in which the 
interrupt dispatcher looks for interrupt service routines once an 
interrupting device Is identified. 

2. The interrupt mask which each individual device specifies when Its 
interrupt service routine gets CPU control. This mask simply 
determines which devices may interrupt this device's interrupt 
service routine. (See DCT Mask Word DCTMS, page A-10.) 
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SOS DEVICE HANDLING STRATEGY (Continued) 

In general, these variables sr juld be consistent among devices; that is, the first 
device in the Interrupt Search List should not be interruptible by any other devices, 
the second device hi the list should only be interruptible by the first, and the last 
one should be interruptible by all other devices. This scheme cannot be rigidly 
adhered to because many devices share a priority bit in the interrupt mask. It is 
recommended that as nearly as possible device handlers observe these conventions. 
There is actually no interdependence between these variables however; if a user 
does not follow these conventions in adding his device handler* he will merely 
introduce slight inefficiencies into the processing of interrupts. The procedures for 
user specification of these device handler variables are discussed later in this 
appendix. 

These considerations broadly summarize the information that must be provided 
to and used by the system to control Level One devices. To properly support 
Level Two devices, several additional pieces of information are required by 
the system: 

1. The system must be able to associate the text string identifying the 
file/device with a physical SOS Channel Number whenever the device 
is opened. (This applies only to systems which use the RDOS to SOS 
Interface Program. When that program is not used, then the SOS 
Channel Number is specified in the ".OPEN" command). 

2. The system must be able to map from the SOS Channel Number to a 
body of information which enables it to recognize the unique properties 
of the device, start it, stop It, and buffer I/O for it. This body of 
information is contained in the Device Control Table, DCT. 

The DCT also contains much of the information that is used by the system interrupt 
dispatcher to service both Level One and Level Two devices at interrupt time. A 
DCT or some subset of it must therefore be provided for every unique device being 
incorporated into SOS, regardless of the device support level. The word by word 
layout of the DCT is described starting on page A- 10. There are various means 
available to the user to link the DCT that he supplies into the system. These options 
are itemized and elaborated noon in the foliov.br section. 



A-3 



SOS DEVICE HANDLING STRATEGY (Continued) 

Hie critical system requirements for each device level are summarized below: 
Level One Devices,* 

1. A DCT 

2. A position in the SOS Interrupt Search List 

3. An interrupt service routine which performs all necessary interrupt 
level device functions and returns control appropriately to the system 
interrupt dispatcher. 

4. A device clear routine which is ^called on all system initializations 
(.SYSI) and resets (.RESE). 

5. All other necessary device control routines. These routines are never 
entered through the operating system however. 

Level Two Devices: 

1. A DCT 

2. A position in the SOS Interrupt Search List. 

3. An interrupt service routine (see above). 

4. A device clear routine (see above). 

5. A (physical) SOS Channel Number associated with the DCT. (Inherent 
in this requirement is a position in the SOS Channel Number Map. ) 

6. A file /device name associated with the SOS Channel Number. This 
only applies to devices which are running in an RDOS-SOS environ- 
ment. 

7. The routines to perform the appropriate subset of system commands 

(. OPEN » . CLOSE , . RDL , . WRL , . RDS and . WRS) meaningful to the 
device. These routines make partial or full use of the SOS global sub- 
routines. 



A-4 



SOS LINKS FOR DEVICE HANDLERS 

Once the user has determined what tilings are required by the sys tern to add a 
device handler, it becomes necessary to know how to supply them. The answer 
[ requires a discussion of the links that are currently enbedded within the system 

for incorporating additional devices. The summary 7 of title existing provisions 
within the system is as follows: 

(1) The SOS Interrupt Search List has positions ( in the form of unresolved 
EXTERNAL NORMAL symbols) for up to five addtional devices. These 
list positions are limited to two of high priority - after the 

| Real Time Clock and before all other devices - and three of low priority - 

] after all other system devices. If more positions are necessary, or if 

| positions at other priorities are necessary, then the user may supply 

j his own Interrupt Search List as described later. 

(2) There are currently five unused SOS Channel Numbers available in the 

| SOS Channel Number to Device Map. These Channel Numbers are 0-4, 

j and there exists an unresolved EXTERNAL NORMAL symbol within the 

map for each of these numbers. Whenever one of these symbols is 
resolved, SOS expects the resolution of the symbol to be the start of 
a user supplied DCT. If these five available channels are inadequate, 
then the user may supply an additional Channel Number to Device Map 
for SOS Channel Numbers higher than 37 . He must then supply the 
appropriate resolutions for the symbols m his high Channel Number 
Map. See SOS Channel Number to Device Map, page A- 17. 

| (3) There are currently five unused file /device names corresponding to SOS 

| Channels 0-4 in the SOS Filename Table: 

j UD00 

UD01 
UD02 
UD03 
UD04 

If these names are unsatisfactory, they may be modified within the table 
by the user. If more names are required (corresponding to added SOS 
Channel Numbers) then the table may be expanded by the user. This 
table is easily accessible because it represents a separate logical record 
in the SOS library. By using the LFE, it can be replaced within the 
library. The one constraint placed on all device /file names is that they 
contain exactly four characters. See SOS Filename Table, page A- 18, 
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SOS LINKS FOR DEVICE HANDLERS (Continued ) 

The details for resolving these system links are given in the following sections. 
Table A-l lists the existing system links and their limitations. Users adding 
device handlers are encouraged to adopt the simplest possible approach in incorpo- 
rating these handlers. Table A -2 lists the general procedures that a user may 
follow to add a device handler according to the complexity of his needs. 
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• 

Global Symbol 


Meaning when Resolved 


SOS Interrupt 
Search List Position 


SOS Physical 

Channel Number 


SOS Associated 
File/Device Name 


,UOOD 


Start of a user supplied 

DCT. 


After Real Time 

Clock; before all 
other devices. 





UDOO 


.U01D 


Start of a user supplied 
DCT 


After UDOO; before 
all other devices. 


1 


UD01 


.U02D 


Start of a user supplied 
DCT 


After all other 
devices. 


2 


UD02 


.U03D 


Start of a user supplied 
DCT 


After UD02 


3 


UD03 


.U04D 


Start of a user supplied 
DCT 


After UD03 


4 


UD04 


.OPPP 


Points to a user supplied 
Table to be used during 
initialization to establish 
an alternative Interrupt 
Search List. See page 
A- 14. 


N/A 


N/A 


N/A 


.OPTP 


Points to a user supplied N/A 
Table which supplements 
the SOS Channel Number 
Map. This table contains 
DCT pointers correspond- 
ing to high SOS Channel 
Numbers (channels greater 
than 37 g ). See page A- 17. 


N/A 


N/A 


.FNAM 


Points to the start of the 
File Name Table. This 
table may require modi- 
fication or expansion to 
add user devices. See 
page A- 18. 


N/A 


N/A 


N/A 



Table A-l System Links for Adding User Device Handlers 
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Interrupt 

Service Requirements 



SOS Channel 

Number Requirements 



File /Device 

Name Requirements 



Simplest 
User Approach 



lowest priority 

any priority 
highest priority 

lowest priority 
lowest priority 
lowest priority 

highest priority 
highest priority 
any priority 



any priority 



none (implies a Level 
One device). 



none 



none 



any one number 
(implies a Level 
Two device). 

any two numbers 



any three numbers 



any one number 



any two numbers 



any five or less 
numbers 



any five or less 
numbers 



specific priority other none 
than lowest or highest 



none 



none 



none 



none 



none 



none 



none 



none 



none 



Any names (implies 
running in RDOS to 
SOS Interface envi- 
ronment). 



none 



Add the supplied DGT to me 
system at runtime through the 
system command ". IDEF". 

Same as above. 

Supply a DGT beginning at the 
ENTRY point ". UOOD", 

Supply a DGT beginning at the 
ENTRY point ".U02D".; use SOS 
Channel 2 to access the device. 

Supply DGTs at ". U02D" and 
".U03D"; use SOS Channels 2 
and 3 to access the devices. 

Supply DCTs at ". U02D", 
".U03D", and M .U04D"; use SOS 
Channels 2, 3, and 4 to access 
the devices. 

Supply a DCT at ". UOOD"; use 
SOS Channel to access the 
device. 

Supply DCTs at ". UOOD" and 
".U01D"; use SOS Channels 
and 1 to access the devices. 

Supply DCTs at ". UOOD" through 
". U04D" as required; use SOS 
Channels 0-4 to access the 
devices. 

Supply DCTs at ". UOOD" through 
*'. U04D* as required. Use the 
names "UDO0", "UD01",..» 
"UD04 " to open the device(s) 
on RDOS Channels. 

Supply the table beginning at the 
ENTRY point ". OPPP" which 

establishes the SOS Interrupt 
Search List; Supply the appro- 
priate DCT. 



Table A- 2 User Approaches for Adding Device Handlers 
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Interrupt 

Sendee Requirements 



SOS Channel 

Number Requirements 



File /Device 

Name Requirements 



Simplest 
User Approach 



specific priority other 
than lowest or highest 



specific priority other 
than lowest or highest 



any five or less 



none 



any five or less 



any names 



any priority 



any five or less 



Names other than 
"UDOO" - "UD04" 



specific priority 



any five or less 



any priority including more than five 

specific priorities 



Names other than 
"UDOO" - "UD04" 

none 



any priority including more than five 

specific priorities 



Names other than 
and in addition to 
"UDOO" - "UD04" 



Supply the ". OPPP" table; supply 
DCTs M .U00D"-".U04D" as 

required. Use SOS Channels 
0-4 is required, 

Supply the ". OPPP" table; 
supply DCTs ".UOOD" - ".U004" 
as required; use the names 
"UDOO" - "UD04" to open the 

devices on RDOS Channels. 

Supply DCTs at ". UOOD" through 
". U04D" as required. Replace 
the FNAME table in the SOS 

Library with a modified table 
containing the desired four letter 
names in the first 20]_q character 
positions. Use these names to 
open the devices on RDOS 
Channels. 

Supply the". OPPP" table; then 
repeat the procedures above. 

Supply the ". OPPP" table; Supply 
the Table beginning at ENTRY 
point ". OPTP" to map the added 
SOS Channel Numbers to DCTs. 
Supply the DCTs at ".UOOD" - 
".U04D" and also the additional 
DCTs as required. Use SOS 
Channels 0-4 and 40, 41, 42, . . . 
as required to access the 
devices. 

Supply the ". OPPP" table. 
Supply the ". OPTP" table. 
Supply the DCTs at ".UOOD" - 
'3040" and also the additional 
DCTs as required. Replace the 
FNAME table with a modified, 
expanded" table. Use these new 
names to open the devices on 
RDOS Channels. 



Table A- 2 User Approaches for Adding Device Handlers (Continued) 
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SOS DEVICE CONTROL TA 3LE (DCT) 

Each SOS device requires a control table. Although some elements of the table 
may not be used by an added driver, the table must be defined exactly as in the 
following description, so that the critical elements reside n t <r- correct displace' 
merits. This table requires 33 octal locations (displacements 0-32 from the DCT 
layout description in the SOS Parameter Tape), ""he^e c^'solaceiiieiits and their 
meanings are as follows: 



Equivalence 




Displacement 
DCTCD 



Meaning 

The octal device code. Must be assembled 
into the table. 



DCTMS 



The mask of all lower priority devices, 
including this device. This mask is used 
to disable interrupts from all lower 
priority devices while processing an 
interrupt from this device. This mask 
should reflect the priorities established 
by the SOS Interrupt Search (see next 
section). The mask bits are defined in 
the SOS parameter tapes, and must be 
assembled into the table. See Figure A -2. 



DCTCH 



The active device characteristics from the 
RDOS User Parameter Tape. This word 
is derived by masking the complement of 
the user's AC1 on a ".OPEN" command 

with the device's fixed characteristics 
(see DCTFC). The device's fixed charac- 
teristics must be assembled into the 
table; they are not referenced for Level 1 
devices. 



DCTLK 



The link to the next priority device, a 
pointer to its control table. This word is 
initialized by a » SYSI. Hie priorities are 
established by SOS Interrupt Search List. 



DCTIS 



The address of the interrupt service 
routine. The address must be assembled 
into the table. (See SOS Interrupt Handling, 

page A- 22. 
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SOS DEVICE CONTROL TABLE (DGT) (Continued) 

Equivalence Displacement Meaning 



DCTIL 



DCTDT 



The interrupt frame links. This points 
to the DCT of the last interrupted device. 

This word is maintained by the SOS 
interrupt -service dispatcher. 

The Command Dispatch Table address for 
this device. The Command Dispatch Table 
must be ordered in the following manner: 

- open routine address 

1 - close routine address 

2 - read/write sequential routine address 

3 - read /write line routine address 

Any of the before mentioned functions that 
are illegal for a device should contain a -1 
in their location. The address must be 
assembled into the table. (See Device 
Start, Stop, and Dispatch Routines, page 
A-23. 



DCTST 



10 



DCTSP 



11 



DCTFL 



The address of the device start routine. 
Hie address must be assembled into the 
table. See Device Start, Stop, and 
Dispatch Routines. 

The address of the device stop routine. 
The address must be assembled into the 
table. See Device Stop, Start and Dis- 
patch Routines. 

Hie device flags. These flag bits are 
maintained by the global SOS subroutines. 
Three flags are currently defined; 



DCACT=1B15 



- Device is active (executing 
I/O). Must be off to per- 
form a SOS reset. 



DCACP=1B8 - 



A keyboard input device 
may accept a character. 
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SOS DEVICE CONTROL TABLE (DCT) (Continued) 

Equivalence Displacement Meaning 

11 DCTFL DCKMD=1B0 

(continued) 



12 



DCTBS 



13 



DCTBF 



14 
15 



DCTBL 
DCTIP 



16 



DCTOP 



17 



DCTCN 



A keyboard input device 
is in echo mode. Echo 
the input character, 



The size of the device buffer (in bytes for 
character devices, in words for full word 
devices). It must be assembled into the 
table. 

Buffer first byte (word) address. If the 
device is a full word device (DCFWD 
characteristic), then this location must 
contain the beginning word address of the 
buffer. For character devices, this word 
must contain the beginning byte address 
of the buffer. 

Buffer last byte (word) address. 

Buffer current input pointer. For an output 
device, this is the byte address at which 
to store the next byte sent to the device from 
the user program. For an input device, this 
is the byte address at which to store the next 
byte received from the device. This word is 
maintained by the global SOS subroutines. 

Buffer current output pointer. For an out- 
put device, this is the byte address from 
which to fetch the next byte for output. 
For an input device, this is the byte add - 
ress from which to fetch the next byte 
requested by the user program. This word 
is maintained by the global SOS subroutines. 

Count of active data in the buffer, i. e. , 
bytes not yet sent to the device or bytes 
not yet moved to the user program for 
output and input devices respectively. 
This word Is maintained by the global 
SOS subroutines. 
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SOS DEVICE CONTROL TABLE (DOT) ( Continued) 



Equivalence 
20 



Displacement 

DCTTO 

DCTCC 



21 



DCTRC 



22 



DC TAT 



23 



DCTFC 



Meaning 

Timeout constant (all input devices). 
Column counter (all output devices). For 
input devices this word represents the 
maximum time interval during which they 
may have outstanding data following a 
start pulse. The parameter "SCTM" 
defined on the RDOS User Parameter Tape 
corresponds to a time of 1 millisecond on 
the Supernova SC. Then, if a device 
requires 6 milliseconds to timeout, the 
word can be assembled as: 

6*SCTIM 

For output devices, this word is main- 
tained by the global SOS subroutines. 

Restart constant (all input devices). Line 
counter (all output devices). For input 
devices, if the active data count is less 
than this constant, another start pulse 
should be sent to the device. This word 
must be assembled into the table. For 
output devices, this word is maintained 
by the global SOS subroutines. 

Device attributes. Fixed bit settings that 
are always returned to the user in AGO on 
a . GTATR command. Attributes include 
attribute protected, permanent, read 
protected, and write protected. See RDOS 
User Parameter Tape. 

Device fixed characteristics. These charac- 
teristics, from the RDOS User Parameter 

Tape, always become the active charac- 
teristics (DCTCH) after the device is 
OPE Ned, unless they are suppressed by 
the AC1 mask. 
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SOS DEVICE CONTROL TABLE (DCT) (Continued) 

Equivalence Displacement Meaning 



24-32 



24 
25 
26 
27 
30 

31 
32 



IACO 
IAC1 
IAC2 
IAC3 
IPC 

IRLOC 
MSK 



Device Interrupt Frame, The machine 
state at the time of a device interrupt is 
saved in these DCT locations. The layout 
of the interrupt frame is as follows: 

Saved AGO. 

Saved AC1. 

Saved AC2. 

Saved AC3. 

Program Counter. (Location when the 
interrupt was taken. ) 

Volatile SOS linkage cell. 

Interrupt enable mask when the interrupt 
was taken. The carry bit is saved in bit 
14 of this word. 



DCT displacements 6-23 (DCTDT - DCTFC) are not referenced by Level 1 devices, 
with the exception of DCTFL, bit 15, which must be off to perform a SOS reset 
command, and DCTSP, which is executed on .SYSI and .RESET commands. For 
Level 2 devices, the Dispatch Table (DCTDT) must be defined. Use of the remaining 
elements depends on the definitions of this table; if any of the global SOS routines are 
invoked, men any or all of these elements may be referenced. 

SOS INTERRUPT SEARCH LIST 



This list is established when a SOS initialization (system command ". SYSI") is per- 
formed; this "list" itself is merely the order in which DCTs are linked together. 
(See DCT Link Words, page A- 10.) The order in which the DCTs are linked 
determines the order in which the SOS devices are searched for a matching code on 
an interrupt. This link order is derived from a table mat is normally embedded in 
SOS -MAIN. If the EXTERNAL NORMAL symbol . QPPP in SOS -MAIN is resolved 
however, then a user supplied table is used to establish the links. The table consists 
of a list of pointers to DCT addresses . Each of the pointers is an ENTRY point in 
SOS -MAIN. The added level of pointers makes it possible for the user to define this 
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SOS INTERRUPT SEARCH LIST f Coniii'iicd) 

table ami load it before the SOS library without affecting the conditional loading of 

any of the device drivers. The SOS-MAIN table is set up as follows: 

.RTCP 

• UOOP 
.U01P 

• PTRP 
.CDRP 
.MTAP 
.CTAP 

• TTRP 
.TOP 

. tup 

.PTPP 
.LPTP 
.PLTP 
.TTOP 
.TOIP 
.U02P 
.U03P 
.U04P 
Table Terminator 

Each of the symbols ending in "P" is declared an ENTRY in the SOS -MAIN program. 
Each ENTRY point contains the corresponding DCT address. Whenever the DCT is 
not loaded, the next symbol is examined to find a loaded DCT to link to the previous 
one. The table is always terminated with a zero word. This table reflects a 
descending priority level of SOS devices, beginning with the Real Time Clock and 
ending with user defined device number 4, If the user wishes to use this existing 
table to establish his device priorities, he must accept a priority that is either 
higher than all devices except the Real Time Clock or else lower than all system 
devices. Up to five devices may be defined; two may occupy the highest priority 
positions and the other three occupy the low priority positions. The user must then 
assign the appropriate (low) SOS Channel Numbers to the devices if they are Level 
Two devices. If the user wishes device priorities other than these, he must supply 
his own table, beginning at ENTRY point . OPPP , 

As an example of a user supplied table, consider the addition of six devices, 
UDOO - UD05. UDOO, UD02, and UD04 require the top three priority slots respec- 
tively. UD01 and UD03 may occupy the lowest priority slots and UD05 requires a 
priority higher than the Magnetic Tape Controller but lower than the Card Reader. 
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SOS INTERRUPT SEARCH LIST (Continued) 

Hie critical program declarations to achieve this priority scheme would appear as 
follows: 

. ENT . OPPP 

.EXTN ,PTRP» .CDRP, .TTRP, . PTPP, , LPTP 

.EXTN .TTOP, .MTAP, . CTAP, . TTIP, ,TI1P 

, EXTN .PLTP, .TOIP, . RTCP 



. OPPP: 



. NREL 
.UOOP 
,U02P 
.U04P 
.RTCP 
.PTRP 
.CDRP 
.U05P 
.MTAI 
.CTAP 
.TTRP 
.TTIP 
.TUP 
.PTPP 
.LPTP 
.PLTP 
.TTOP 
.TOIP 
.U01P 
.U03P 




; table terminator 



.UOOP 
.U01P 
.U02P 
.U03P 
.U04P 
.U05P 



. UOOD ;pointer to UDOO DCT 

.U01D ;pointer to UD01 DCT 

. U02D ;pointer to UD02 DCT 

» U03D ;po inter to UD03 DCT 

. U04D jpointer to UD04 DCT 

. U05D jpointer to UD05 DCT 



All pointer symbols for device drivers that are never desired may be omitted from 
this table. 
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SOS CHANNEL NUMBER TO DEVICE MAP 

This table is referenced by the SOS command dispatch routine and is normally 
embedded in the SOS -MAIN program, Within this table, there are SOS Channel 
Numbers available for up to five additional devices. These SOS Channels are 0, 
1, 2, 3» and 4. If this number of positions is adequate and the SOS Channel numbers 
acceptable then the user need not define his own map. He needs merely to resolve 
the DCT addresses that are declared EXTERNAL NORMALS in the SOS -MAIN pro- 
gram. This is done by declaring the symbol an ENTRY point and resolving it as the 
beginning location of the DCT. Hence to add five devices UD00 - UD04 on SOS 
Channels 0-4, the following declarations would be necessary: 



ENT 



NREL 



.U00D, .U01D, .U02D, . U03D, . U04D 

These names must be used for the DCT 
beginning locations 



U00D: 



;UD00 DCT 

60 

-1 



device code 60 

mask out all other devices 



U01D: 



;UD01 DCT 
61 



; device code 61 



. U02D: 



;UD02 DCT 
62 



; device code 62 



U03D 



;UD03 DCT 
63 



; device code 63 



U04D: 



;UD04 DCT 

64 ; device code 64 



If more than five devices are being added or if SOS Channel Numbers other than 
0-4 are desired for the devices, then the Channel -Number -to -Device Map must be 
supplemented by the user. The supplementary map is referenced when a Channel 
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SOS CHANNEL NUMBER TO DEVICE MAP (Continued) 

Number outside of die legal SOS range has been specified in an I/O command and 
the EXTERNAL NORMAL symbol . OPTP has been resolved. The address contained 
at this location is expected to point to a list of DCT addresses which correspond to 
devices using SOS Channel Numbers beginning at 40 (HCHNOf 1 from the SOS 
parameters). Thus if a user wishes to add 8 devices on SOS Channels 0-4 and 
40-42, besides the declarations shown above that are necessary for five of the eight 
devices, the following declarations are necessary for the remaining 3 devices 
(UD05 - UD07): 



. ENT 



.OPTP 



«NREL 



OPTP: 


,+i 




U05P: 


.U05D 


; pointer to U05 DCT 


U06P: 


. U06D 


; pointer to U06 DCT 


U07P: 


. U07D 


; pointer to U07 DCT 



Devices UD05 - UD07 would then occupy SOS Channel positions 40-42. Only Level 
Two devices require the Channel -Number -to -Device Map. The supplementary map 
is expandable from SOS Channel Number HCHNO+1 to number 76 . 

SOS FILENAME TABLE 

This table is used by the SOS command dispatch routine whenever a file/device is 
. OPENed in an RDOS-SOS environment. The table is simply a text string which 
begins at the ENTRY point . FNAM . A zero word terminates the table. Each four- 
character file /device name recognized by SOS is contained in this table; the first 
four character string represents the SOS Channel device, followed by the SOS 
Channel 1 device, and so on to the SOS Channel 37 device. Whenever a ".OPEN" 
command is executed, this table produces the SOS Channel Number from the passed 
file/device name. The user may wish to modify this table in one or both of two ways: 

1. By changing one or more of the existing names to a more descriptive name 

for his own device(s). 

2. By adding names at the end of the table which correspond to devices added 
on SOS Channels 40, 41, etc. (See previous section.) 



hi either case, new filenames must be exactly four characters in length. 
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sos ri T J-:\Ayi-: v.\\)u : . <c-nvivuci\) 

When the table has been modified and assembled, the user may REPLACE the exist- 
ing SOS Library table by using the LFE and generating a new library, This table 

is only necessary for users running hi an RDOS-SOS environment, Figure A-l 
shows the current FNAME program in the SOS Library, 
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IKOOS F T(_i NAME STRINGS 



'4 3 




34 


j/. fit *« f* *4 | 


35 


■j, p n r« r* i 


Tift 




H? 


« fl o» n ,?. t '/ «S ? «i i< 4 


■*ii 


•> 3 H'K" 


3§ 


•*3? K -**4 


1 W 


4 3 J1 ?■ ft I 


1 I 


•» * 2 5 i' 4 


12 


^3C > '»«9 


13 


A *) 2 * ,>. 4 


1 4 


/ 3 » •"* *> 3 


1 D 


-^59**4 


1 *> 


•/■ 3 ;■• f"h4 


\7 


^S?t ?4 


1» 


/. 4 4 4 ri J 


I ^ 


-i'*M 4 » 399 J ?« 


9t* 


3 4 !S 1 2 4 


91 


» • 5 219 4 


5? 


M 4 7 4 h 1 


93 


* 9 21 9 4 


94 


^ 5 9 1 2 P- 


?!> 


•'.9 21 '3 3 


96 


3 4 V 1 9 9 


97 


•'99194 


94 


^91 1.7 


90 


7 9 919 4 


3* 


P? ? 1i J 


31 


,?,?;> 1 J 4 


3 9 


"t 5 3 1 2 4 


3,3 


•■■ 9 9 1 9 P 


3 4 


" * 9 \ 2 2 


35 


■a 9 9 1 ? 3 


3ft 


»V<M2P 


37 


3 9 9 19 4 


33 


•/ •> ? 1 9 9 


3W 


U*f/4f« ! ;• 4rS? 4 


4 H 


>"• 3v,fi7? 


41 


? 4 to 5 '<■> 4 


42 


•/ 3 •* & 7 9 


4,5 


t 4**9 4 


44 


r 3 1*7? 


45 


./- 4 'i ?> 2 4 


4*> 


V-.3M7? 


47 


n 4 *■ => 9 4 


48 


-3? i-7? 


4<i 


• s 4 * b 9 4 


Sv> 


,^39 4 7? 


SI 


<» 4 * S 9 4 


5? 


* 3 3 ? 7 9 


S3 


-• 4') ^9 4 


34 


•■ 3 3 4 7 9 


3 5 


«!"•*, - i '14 1 ^9 4 


•5 6 


„ T, r,, p -J J 


37 


i* 4 1 5 9 4 


3d 


'3'^? 


S o 


34J «i9 4 


p;i 


331P79 



?9 




,1 TTIF 


PNAf-E 


,fWT 


. Mi|M 


, h P F 1 




,TXT M 


1 


. T * T «M 


1 



.FNAMJ .TYT /U0f f 'ffl!jD^l(l')P , 9U0fl3u0=34TTn / 



. T*T /,$PLTTTni.fTTPS;C0»$TTn«TTT*LPTSPTB$PTPSTTP7 



/^Tf8KT!i!MT?JhT3 8MT4»MT?tMT6tMT78/ 



. T * T /CT!/JCTi:CT9JCT38CT48CTh:CTfiJCT78/ 



Figure A-l SOS FNAME Program 
A -20 



; M • * ? f- f. h , i f 


n 


•>» 4 M 2 4 


•a 2 


•Ml 47 2 


M 


i.4M?4 


^4 


MPfMP 


A3 


;-^M?4 


16 


,'■ -3 9 4 7? 


ci7 


'-' 4 | 5 2 4 


MS 


-MJ0 7? 


■<W 


"41, S? 4 


\* 


• •• M 4 7 ? 


| J ...-»} »,» f ., ',) • •!>..» ^ 


1? 




13 





»TAf<Lfc TFRMlMATf.R 



# t«n 



Figure A-l SOS FNAME Program 
A-21 



SOS INTERRUPT HANDLING 

When an interrupt is taken, the SOS interrupt dispatcher preserves the interrupted 
machine state, The DCT interrupt frame (IAC0 - IMSK) is utilized in these pro- 
cedures, and when the device interrupt handler gains control, the "save" is complete 
and the mask in the device's Control Table (DCTMS) is active. The following functions 

are the responsibility of the interrupt routine (DCTIS): 

i. Clearing the done flip-flop hi the device, 

2. Storing/retrieving the next character in the device buffer. 

3. Restarting the device when appropriate. 

4. Returning to the SOS interrupt module. 

The SOS stack mechanism may not be invoked at interrupt processing time. The 
SOS modules . IBUF and . OBUF may be called, however, since they do not require a 
stack frame (see SOS global subroutines). 

Two simple interrupt routines, one for output device $PTP and one for input device 
$PTR, illustrate the above points: 



PTRS: 


DIAC 


I,PTR 




JSR 


@ADRIB 




JMP 


* 




NIOS 


PTR 




JMP 


@.+l 




. EXTN 


.DISM 




. DISM 






. EXTN 


.IBUF 


ADRIB: 


.IBUF 





RETRIEVE CHARACTER/ 
CLEAR DONE 

STORE CHARACTER IN THE 
DEVICE'S BUFFER 
AN IMPOSSIBLE RETURN- 
BUFFER ALREADY FULL 
RESTART $PTR. THE 
BUFFER IS NOT YET FULL 
DON'T RESTART $PTR. THE 
BUFFER BECAME FULL 

;RETURN TO THE SOS 
; INTERRUPT MODULE 

; ENTRY POINT 
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SOS INTERRUPT HANDLING (Continued) 



FTPS' NIOC 
JSR 

DOAS 



JMP 
.DESM 

. EXTN 
ADROB: . OBUF 



FTP 
@ADROB 

1,PTP 



@.+l 



.OBUF 



CLEAR DONE 

RETRIEVE NEXT CHARACTER 

FROM TOE DEVICE'S BUFFER 

RESTART DEVICE AND SEND THIS 

CHARACTER IF THE RETURN CAME 

HERE 

OTHERWISE DON'T RESTART 

RETURN TO THE SOS INTERRUPT 

MODULE 

ENTRY POINT 



DEVICE START, STOP, AND DISPATCH ROUTINES 
Device Start Routine 

The address of this routine is at displacement DCTST in the DCT. For output 
devices, this routine should send a start pulse plus the character from AC1. If the 
device will not interrupt as a result of this action, return to one location beyond the 
normal return location. Otherwise, return to the normal location. AC3 points to 
the normal return location. As an illustration, consider the line printer start 
routine: 



LPTST: 


DOAS 


1,LPT 


.START LPT f OUTPUT THE 
.CHARACTER 




SKPBZ 


LPT 


WILL IT INTERRUPT? 




IMP 


0, 3 


,YES 




JMP 


1, 3 


,NO 



For input devices, this routine should send a start pulse and return to the normal 
return location. For example, the $PTR start routine is: 



PTRST: NIOS 


PTR 


;SEND START PULSE 


JMP 


0, 3 


;RETURN 


Device Stop Routine 







The address of this routine is at displacement DCTSP in the DCT. This routine should 
simply send a clear pulse and return to the normal return location. Using the $PTR 
as an example: 
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Device Stop Routine (Continued) 

PTRSP: NIOC PTR ;SEND CLEAR PULSE 

JMP 0, 3 ; RETURN 

This routine is executed for each device on any , RESET or , SYSI. 

Device Dispatch Routines 

The device dispatch table address is at displacement DCTDT in the DCT as 
previously described. If the global SOS routines are not invoked for any of the four 
functions, then the following points should be noted in the dispatch routine: 

1. AC3 points to the error return location. 
Increment by one for a success return. 

2. The contents of the user accumulators are: 

AGO - page zero displacement "CACO" 
AC1 - page zero displacmenet "C AC 1" 
AC2 - UST displacement "USTA2" 

If an accumulator is being returned to the user, then the appropriate 
location must be changed. 

3. AC2 points to the DCT when the dispatch routine gains control. 

All of the above equivalences are defined in the SOS Parameter Tape. 

If the global SOS routines are used, then they may be invoked directly (by assembling- 
their addresses into the dispatch table). 

SOS LINKAGE 

A simple stack mechanism is employed in SOS at the non- interrupt level. This 
mechanism provides a means of saving the calling routine's accumulators and of 
operating on variables stored in the stack. No stack mechanism is provided for 
interrupt processing but the state of the current stack must be preserved whenever 
an interrupt is processed. The SOS interrupt dispatch routine performs this 
service. 

The linkage scheme used in SOS makes use of several page zero locations and of a 
fixed block of core assembled into the SOS -MAIN module. The size of this core 
block permits a "depth" of six calls from the common SOS entry point at the start of 
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SOS LINKAGE (Continued) 

the program. Hie page zero locations and equivalences that are used in the linkage 
mechanism include: 

SAVE - 0SR @3) invokes the routine which saves accumulators and updates 
the stack pointer, 

RTRN - 0MP @4) invokes the routine which restores the caller's accumula- 
tors and returns to him. 

CSP - (Page Zero Location) always points to the stack frame currently in 

use. 

RLOC - (Page Zero Location) used as a temporary by the SAVE routines; 

may also be used as a temporary by any routine in lieu of allocating 
a stack frame. 

The stack frame is a fixed size with the following displacements defined: 

RTLOC - The return location in the current subroutine (location which it last 
"called"). 

AGO - Contents of accumulator of the current subroutine at the last call 

which it made. 

AC1 - Same as above; accumulator 1. 

TMP - Available for use by (he current subroutine as a temporary. 

OACO - Contents of caller's accumulator 0. 

OAC1 - Contents of caller's accumulator 1. 

OTMP - Caller's temporary. 

ORTN - Caller's return location. 

Following a SAVE or a RTRN, AC3 always points to the current stack frame, and 

each of the above locations may be referenced as displacements from it. Otherwise, 
the CSP may be loaded into an index accumulator in order to reference the locations. 
(Accumulator 2 is never saved since it usually contains a Device Control Table 
address and is passed as an argument from subroutine to subroutine, ) 
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SOS LINKAGE (Continued) 

The typical procedures executed in using the mechanism are as follows: 

1. A routine (B) is called by another routine (A) through the JSR instruction: 

JSR B 

or 
JSR @ADDRB 

ADDRB: B 

2. Routine B saves the caller's return location when it begins execution 
with: 

STA 3,@CSP 

3. Routine B may, at any time thereafter, perform a: 

SAVE 

to save the caller's accumulators, allocate a stack frame, and update 
the CSP appropriately. 

4. To return to A, routine B simply performs a: 

RTRN 

If no frame is required by B, it may save the caller's return locations 
in RLOC: 

STA 3, RLOC 

It may then use any accumulator and operate on A's frame (by loading 
CSP into an index accumulator) if it wishes. It should perform the 
return in the following manner: 

LDA 3, CSP 

JMP @RLOC 

so that when A regains control, accumulator 3 is pointing to its frame. 
Note that the accumulators upon this return are exactly as they were 

left by routine B, rather than as they were when A called B. All of the 

above equivalences are defined in the SOS Parameter Tape. 
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GLOBAL SOS SUBROUTINES 



The global routines defined as ENTRIES in SOS are 


. OPN 


- 


Open 


.CLS 


- 


Close 


. WRSE 


- 


Write sequential 


, WRLI 


- 


Write line 


.RDSE 


- 


Read sequential 


.RDLI 


- 


Read line 


.ACHR 


- 


Send a character 


.RCHR 


- 


Read a character 


.IBUF 


- 


Input a character to buffer 


.OBUF 


- 


Output a character from buffer 


.STB 


- 


Store a byte 


.LDB 


- 


Load a byte 


.DISM 


- 


Dismiss an interrupt 


.IDCT 


- 


Initialize DCT 


.SYSE 


- 


System error 


GENERALIZED SOS SUBROUTINES 



These routines are available for use with any programs loaded with SOS. The calling 
procedures and brief descriptions are given below: 

.OPN 



Calling 

Sequence: JSR .OPN 

(All references to JSR .XXX instructions, where .XXX is an entry 
point, are equivalent to the following instruction sequence: 

JSR @XXX 

XXX: . XXX ) 

Arguments: AGO = Byte address of the file name if the device is an intervention 

device. Otherwise, AGO is ignored. 

AC2 = Pointer to the DCT. 

Return 

Sequence: Always returns to calling location +2 with the accumulators unchanged. 
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GENERALIZED_SOS_ SUBROUTINES (Continued) 

. OPN (Continued) 

Description: The device's active characteristics are derived by ANDing the com- 
plement of the user's ACi and the device's fixed characteristics 
(DCTFC); they are stored at DCTCH. Then, if the device being opened 
is an intervention device, a prompt message is typed. If the device 
requires leader/trailer, it is punched. The device is always cleared 
(DCT stop routine) and the Device Control Table is initialized. 

.CLS 



Calling 

Sequence: JSR .CLS 

Arguments: AC2 = Pointer to the Device Control Table. 

Return 

Sequence: Always returns to calling location +2 with the accumulators unchanged. 

Description: If the device being closed requires leader/trailer, it is punched. When 
the device is no longer active, it is cleared and its Device Control 
Table is initialized. 

. WRSE 



Calling 

Sequence: JSR .WRSE 

Arguments: "CACO"* = Beginning byte address for transfer 
"CAC1" * = Byte count for transfer 
AC2 = Pointer to Devifte Control Table 

Return 

Sequence: Always returns to calling location +2 with the accumulators unchanged. 

Description: The specified number of bytes are inserted into the device's buffer for 
output. 



* Page zero displacements from the SOS Parameter Tape. 
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G ENERALIZED SO S SUBROUTINES (Continued) 
. WRLI 



Calling 
Sequence: 



JSR .WRLI 



Arguments: CACO = Beginning byte address for the transfer, 
AC2 = Pointer to the Device Control Table. 



Return 
Sequence: 



The accumulators are unchanged, except CAC1 which contains the 
count of bytes written. A return to the calling location +1 indicates 
the maximum line length was exceeded. A return to calling location 
+2 Is normal. 



Description: The specified ASCII characters are inserted into the device's buffer 
for output. The character string that is output is terminated by: 

1. carriage return 

2. form feed 

3. null byte 

Line editing is done, based on the characteristics of the device. 

.ROSE 



Calling 
Sequence: 



JSR .RDSE 



Arguments: CACO = Beginning byte address for the transfer 
CAC1 = Byte count for the transfer 
AC2 = Pointer to Device Control Table 



Return 
Sequence: 



A return to calling location +1 indicates end of file. A return to calling 
location +2 is normal. The accumulators are unchanged. CAC1 

contains the partial count read on an EOF return. 



Description: The specified number of bytes are placed In the user area from the 
device's buffer. 



A-29 



G ENERALIZ E D SOS SUBROUT INES (Continued) 



.RDLI 



Calling 

Sequence: JSR .RDLI 

Arguments: CACO = Beginning byte address for the transfer. 
AC2 = Pointer to Device Control Table. 

Return 

Sequence: a return to calling location +1 indicates either end of file, line length 
exceeded, or parity error. In this case, CAC1 contains the partial 
count of bytes read and CAC2** contains the error code. A return to 
calling location +2 is normal, with accumulators unchanged except 
CAC1, which contains the count of characters read. 

Description: The specified ASCII characters are inserted into the user area from the 
device's buffer. The character string is terminated by: 

1. carriage return 

2. form feed 

3. null 



Rubouts and line feeds are ignored. 



.RCHR 

Calling 

Sequence: JSR .RCHR 

Arguments: AC2 = Pointer to Device Control Table. 



UST displacement USTA2 from the SOS Parameters (PARA. SR). 
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,RCHR (Continued) 

Return 

Sequence: A return to calling location +1 indicates device timeout (end of file). 
In this case, the accumulators are unchanged with the error code in 
CAC2, A return to calling location +2 is normal, hi this case, the 
right justified byte (word)* that is read is in ACi with the other accumu- 
lators unchanged. 

Description: The next available byte is read from the device's buffer into ACi. If 
necessary, a start pulse is issued to the device. 

.ACHR 

Calling 

Sequence: JSR .ACHR 

Arguments: ACI = Right justified byte to be sent. 

AC2 = Pointer to the Device Control Table. 

Return 

Sequence: A return is always made to calling location +1 with the accumulators 

unchanged. 

Description: The byte is inserted into the device's buffer for output. If necessary, 
a start pulse is issued to the device. 

.IBUF 

Calling 

Sequence: JSR .IBUF 

Arguments: ACI = Right justified byte to be inserted into buffer. 
AC2 = Pointer to Device Control Table. 



* Input devices with the characteristic, DCFWD, always operate, on words rather 

than bytes. 
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GENERALIZED SOS Si/ ; ^0' . ",! LNE.S \' ''-Lied) 

»IBUF (Continued) 

Return 

Sequence: A return to the calling location +1 indicates the buffer is already full. 
A return to calling location +2 indicates the character was inserted and 
the buffer is not full. A return to calling location +3 indicates the 
character was inserted and the buffer became full. In every case, the 
accumulators are unchanged, except ACO, which is destroyed. 

Description: Hie byte (word) is placed in the appropriate buffer slot and the Device 
Control Table is updated accordingly. This routine is used at the 
interrupt processing level by input devices and at the non -interrupt 
level by output devices. 

.OBUF 

Calling 

Sequence: JSR .OBUF 

Arguments: AC2 = Pointer to Device Control Table. 



Return 

Sequence: A return to calling location +1 indicates the buffer is empty. A return 
to calling location +2 indicates the buffer is not empty. In this case, 
the next available byte (word) is fetched from the buffer and returned 
right justified in AC1. In both cases, ACO is destroyed and the other 
accumulators are unchanged. 

Description: The byte (word) is fetched from the appropriate buffer slot into AC1 
and the Device Control Table is updated accordingly. This routine is 
used at the interrupt processing level by output devices (to fetch their 
next byte for output) and at the non -interrupt level by input devices (to 

retrieve bytes from their buffers). 

.STB 



Calling 

Sequence: 



JSR .STB 



Arguments: ACO = Destination byte address. 
AC1 = Right justified byte. 
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;^\j- .!<.'•• I.IVHD SOS.Si;jlROLT_l\H.S (Cuntinucd) 
.STB (Continued) 

Return 

Sequence: The return is always made to calling location +1 with AGO incremented 

and the other accumulators unchanged. 

Description: The passed byte is stored at the specified address. 

.LDB 

Calling 

Sequence: JSR . LDB 

Arguments: AGO = Source byte address. 

Return 

Sequence: The return is always made to calling location +1 with the right justified 
byte in ACi. The other 'accumulators are unchanged. 

Description: The byte at the specified address is loaded and returned in ACI. 

.DISM 

Calling 

Sequence: JMP .DISM 

Arguments: AC2 = Pointer to Device Control Table. 

Return 

Sequence: No return. 

Description: This routine restores the machine to the state it was in before the 

device interrupted. Control is passed to this point when the interrupt 
from the device has been serviced. 

. IDCT - 



Calling 

Sequence: JSR .IDCT 

Arguments: AC2 = Pointer to the Device Control Table. 
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GEXE RA LI ZED_.,^^^BROUTIXES ( Continued ; 

.IDCT (Continued) 

Return 

Sequence; Always returns to calling location +1 with the accumulators unchanged, 

Description: The device stop routine (DCT displacement DCTSP) is called; DCT 
locations DCTCN and DCTFL are zeroed; DCT locations DCTOP and 
DC TIP are set to the contents of DCTBF. 

.SYSE 



Calling 

Sequence: JMP .SYSE 

Arguments: AGO = System Error Code to be returned to ". SYSTM" caller. 

Return 

Sequence: No return. 

Description: An error return is made to the last system command with the passed 
error code stored in caller's AC2. 
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DEVICE DRIVER EXAMPLE 

Figure A -2 shows the device driver for the high speed paper tape punch ($PTP). 

This driver is similar to those of other character oriented output devices. The 
' ; s •:;."•. .-'•"' ov. '5 '"Lr '.-'den the: 

1. Global declarations 

2. Device Control Table 

3. Interrupt service routine 

4. Device start routine 

5. Device stop routine 

6. Device Dispatch Table 

7. Device I/O buffer 



A-35 



l ?. £* ? prp-jQ 



fl2 

04 
05 
06 
07 
08 
^9 
1 m 



I i 
^. 2 

13 

14 

15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
3* 
4 5* 
41 
42 
43 
44 
45 
46 
47 
48 
49 



00000 
CT 1 

8P»09«2 
00003 
00004 

800^5 

e oi 6 

P 7 

0001» 
0&0!1 

00012 

000 13 
Pi I 4 

00015 
00020 
06*022 
2 3 

00024 

00^33 

fc 3 4 

00 35 

0f*03b 

00037 



0^040 
4 i 

0^042 

0P043 

0P044 



00045 
00046 

0* 4 7 

B *» 
080*1 



P ; ^ I 3 . p t p n t 

«j (**;<* 01 

& w f 1 

0^0^33 » 
<* I 

4 5' 
000040 ' 
0CT004? i 

00 01 

051^^50 

000122" 
"1 1 7 2 »• 

00 3 
00 2 
1^0002 

13 1 

00 0*07 

60213 PTPS^ 
6 4 1 ffl 
0fit>ll3 

0^-2401 
177777 



065113 PTPSTS 
001400 

060213 PTPSP? 

0*1400 

177777 OflUFV: 



177777 
177777 
177777 

177777 

0*0024 



PTPOT! 



PTP8S 
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.END 
Figure A-2. Device Driver for $PTP 
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APPENDIX B 

USER APPLICATION ROUTINES 

SA\ P-^ESTOR"' PR O G IV- M <SAY\VJ_) 

This program maintains a user- supplied stack to save the caller's registers 
(3 accumulators, 2 temporary storage locations, and the caller's return location) 
when a subroutine is called, and the program restores the information on the stack 
upon returns. The User Stack Pointer (USP) always points to the executing 
subroutine's stack frame. This subroutine may then access any of the caller's 
registers, as well as any of its own, by using the stack displacements defined in the 
SOS Application Parameter Tape (Appendix C). 

The user must supply the stack before any of the SOS user application routines can 
be used. To provide the stack, the' user merely stores a beginning address for the 
stack into the USP. The address stored in the cell must point to a core block . 
large enough to meet the user stack requirements. No stack overflow check is 
made. If the stack is used only with the SOS library routines, then the value of 
SOSEC in the SOS User Application Parameter Tape gives the maximum number of 
6 -location frames necessary. 

The various features of the SAVRE program are illustrated in the following example 
of step-by- step use of the stack: 

1. To supply the stack, the user may allocate a fixed block of core starting at 

NMAX: 



.SYSTM ;GET NMAX INTO AC1 

.MEM 

JMP . ; ERROR 

STA 1, USP INITIALIZE START OF STACK 

LDA 0, SRKSZ 

.SYSTM ;UPDATE NMAX 

.MEMI 

JMP . ;NOT ENOUGH CORE AVAILABLE 



STKSZ: SOSEC+3^SSEL ;TOTAL STACK SIZE = SOS ENTRY COUNT + 

;USER'S ENTRY COUNT * ENTRY LENGTH 
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SAVE^ RESTORE PROGRAM (SAVRE) ^Continued) 

1, (Continued) 

Or, instead of starting at NMAX, the user may alternatively allocate any- 
fixed block of core: 

LDA 0, STACK ;LOAD STACK POINTER 

STA 0, USP ;STORE IN USP 



STACK; .+1 

,BLK SOSEC*SSEL ;SOS SIZE IS ADEQUATE 

2. To save the caller's registers when a subroutine is entered via a JSR SUBR 
instruction: 

.EXTNSAVR, RETR 
SUBR: STA 3, @USP ;SAVE -RETURN LOCATION IN STACK 

SAVR ;SAVE REGISTERS 

« 

: ;AC3— ^SUBR's FRAME 

3, To access the caller's registers (which are Intact when the subroutine is 
entered): 



STA 2 , OAC0, 3 
ISZ OAC2, 3 
ISZ ORTR, 3 
DSZ OT1, 3 

STA 1, TO, 3 



RETURN AC2 IN CALLER'S AGO 
INCREMENT THE RETURNED AC2 
INCREMENT RETURN LOCATION COUNTER 

DECREMENT CALLER'S TEMPORARY 
STORE MY OWN TEMPORARY 



4. To return to the calling subroutine: 

RETR ;RETURN TO CALLER 

5. To pop multiple stack levels, i.e. , make an exceptional return, the external 
command, ERETR, has been defined. To illustrate use of this feature, 
consider five subroutines: A, B, C, D, and E, executing at three levels: 

1, 2, and 3, 

Subroutine A executes at level 1. Subroutines B, C, and D execute at level 

2, Subroutine E executes at level 3. Subroutine A calls B, C, and D, each 
of which may call E. 
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SAV E-RES TO RE PROGRAM (SAVRE) ^Continued) 

5, (Continued) 

When a special condition is encountered by B, C, D» or E, subroutine A 
may want to regain immediate control. This is achieved by performing 
the ERETR in any of these subroutines provided that subroutine A has 
performed the logic shown below. 



.EXTD ERAD, ERSUP 
.EXTN ERETR 



ST A 3, @USP 
SAVR 



;SAVE REGISTERS 



LDAO, AERAD 
ST A 0, ERAD 
STA 3, ERUSP 



JSTORE EXCEPTIONAL RETURN ADDRESS 



JSR B 



JSR C 



JSR D 



AERAD: SPECR 



jEXCEPTION RETURN ADDRESS 



SPECR: LDA 0, VAR 

STA 0, OAC1, 3 



;REGAIN CONTROL HERE ON EXCEPTIONAL 
CONDITION AND CONTINUE 



VAR: .BLK 1 



This mechanism returns control unconditionally to location SPECR 
upon the execution of an ERETR by subroutine B, C, D, or E. The 
stack pointer will be A's original pointer and the caller's registers 
are unchanged but the registers returned to A are indeterminate. 
One case in which this feature could be used is in string processing, 
where special characters may require special processors or 
signal the termination of a set of processors. 
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SAVE-RliSTORH PROGRAM iS.WRE) iCo-ti'v:^') 

^. (Continued) 

Following Is a list summarizing the external declarations necessary to use 
the Save -Re store program: 

.EXTN SAVR, RETR ;USE OF THESE FEATURES IS OPTIONAL 

.EXTN ERETR ;USE OF THIS FEATURE IS OPTIONAL. 

rHOWEVER, IF USED, IT REQUIRES THE 
;EXTERNAL DISPLACEMENTS THAT FOLLOW 

.EXTD ERUSP, ERAD ;MUST BE DECLARED AND INITIALIZED 

;TO USE EXCEPTIONAL RETURN 

COMMAND TABLE BUILDER (CTB) PROGRAM 

This program reads a command line from the $TTI into a user- supplied core block 
and dissects the line into a table of string (byte) pointers and flag bit settings. 
Blank characters in the line are considered string separators. The table is the 
effective SOS equivalent of the RDOS COM. CM file (see 093-000075, Appendix D). 
The table is intended only for the SOS user employing the RDOS to SOS Interface 
Program, described in Chapter 1. 

The table produced by this program, the translate table used to derive the flag bit 
settings, and the input buffer for reading the command line must be supplied by the 
calling program. The SOS user stack (see Save-Restore Program) must also be 
supplied by the caller. 

The command line that is read may be continued by typing a SHIFT N (up arrow) 
character one position before the carriage return. The RUBOUT key (echoed as 
a back arrow) causes the preceding character to be deleted from the line. The 
current line may be deleted by typing SHIFT L (backslash). A facility to output a 
prompt message before reading the command line also exists in the program. 

One command table entry is created for each unique string In the input line. Each 
of these strings may be modified by multiple alphabetic switches (/a where a is a 
single letter) and /or one numeric switch ( /n where n is a digit 0-9), The slash 

which designates the switch character may follow the string directly or be sep- 
arated by one or more blanks. The same applies to succeeding switches modifying 
the same string. The switch character must directly follow the slash, the next 
character examined will be considered the start of a new string. Any characters 
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which follow the switch character are ignored. These features are illustrated by 
the following equivalent argument strings; 

$PTR/2 /F /A 

$PTR/A/F/2 

$PTR/A /FINAL /2 

$PTR /ASCII /F /2 



The layout of the command table built by the program is given in the SOS User 
Application Parameter Tape, 090-000889. Each unique string scanned in the 
command line causes a two-word entry to be added to the table. The first word 
at displacement CTSW contains bit settings which correspond with switches that 
modified the string. This correspondence is established in part by another user- 
supplied table. Bits 11-15 of this wprd are reserved for the following use: 



Bits 12-15 



Bit 11 



A four-bit octal number derived from the numeric 
switch modifying the string. If no numeric switch is 
specified, no bits are set. Maximum value is octal 11. 

Set if one or more undefined switches modify the string. 



The user- supplied translate table (TRT) establishes the definition of bits 0-10 of 
this table. This allows eleven user specified alphabetic switches. The address of 
translate table is one of the arguments passed to the program. The table occupies 
at most 11 locations which specify the bit position/alphabetic switch correspondence, 
The following examples illustrate the use of the table; 



TRT: 



"C 

"E 

"B 

"X 

"A 

"M 

,f T 

"Z 

"H 

*'P 

"S 

-1 



/C = BIT 
/E = BIT 1 
/B = BIT 2 
/X = BIT 3 

/A = BIT 4 

/M = BIT 5 

/T = BIT 6 

/Z = BIT 7 

/H = BIT 8 

/P = BIT 9 

/S = BIT 10 

TERMINATES TRANSLATE TABLE 
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COMMAND TABLE BUILDER (CTB) (Continued) 

The example of a translate table shown on the previous page, defines eleven 
alphabetic switches - C, E, B, X, A, M» T» Z, H, P, and S - to map respectively 
to bits 0-10 of the switch word. All other alphabetic switches result in the 

setting of bit 1 1 of the switch word. 



TRT: 



"A 


;/A = BIT 


"L 


;/L = BIT 1 


"B 


,/B = BIT 2 


"N 


/N = BIT 3 


-1 


TERMINATES TABLE 



The previous translate table defines four alphabetic switches - A, L, B, and N - 
to map to bits 0-3 of the switch word. All other alphabetic switches result in 
the setting of bit 11 of the switch word. The utility of the table may be increased 
by inserting the following equivalences into the program: 



SWA = SWO 
SWL = SW1 



SWB = SW2 

SWN = SW3 



Symbols SWO, SW1, SW2, and SW3 are defined in the SOS User Application 
Parameter Tape. 

The following sample sequence of code may then be executed to examine the flag 
bits in each table entry: 



LDA 2, .CT 

LDA 1, MASK 
LOOK: LDA 0, CTSW, 2 

AND 1, 0, SZR 

JMP OUT 

INC 2,2 

INC 2,2 

JMP LOOK 
OUT: 



AC2 — ^COMMAND TABLE 

AC1 = MASK WORD 

AGO = SWITCH WORD 

SWITCH "A" OR M N" ON? 

YES 

NO 

LOOK AT NEXT ENTRY 



MASK: 
.CT: 



SWA + SWN 
CT 



;"A" AND "N" SWITCH BITS 
;ADDRESS OF COMMAND TABLE 
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COMMAND TABLE BUILDER (CTB) (Continued) 

The calling procedure necessary to invoke the program is the following: 

JSR .CTB 

arg 1 

arg 2 

arg 3 

arg 4 

arg 5 

return location 

The arguments passed are the following: 

arg 1 The byte address of any prompt message to be typed on the $TTO. 
If this argument is a -1, then no message is typed. 

arg 2 The byte address of the input buffer used to read the command line. 

arg 3 The maximum byte size of the input buffer. If this length is exceeded 
through use of continued input lines, the read is terminated and 
reissued beginning with the prompt message. 

arg 4 The beginning address of the command table to be created by the 
program. The maximum size of this table is determined by the 
maximum input buffer length. The table may have at most one entry 
for every word in the input buffer. This is the case in which every 
other input character is a string separator. 

arg 5 The beginning address of the translate table to be used to interpret 
the string switches. 

The arguments returned are: 

1. The new Command Table, formatted as in the above description. 

2, The Command Table entry count in AGO. 
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COMMAND TABLE BUILDER (CTB) iCo?:ti'v.:ed) 

Accumulators i and 2 are unchanged; accumulator 3 contains US P. All channels 
will be closed. Channels and 1 are used to read and write the command line 
and must therefore be closed when the program is entered. The SOS user stack 
must have been supplied and initialized as shown in the preceding section. 

A sample program which calls the CTB program and repeats the call if less than 
three unique strings are input is coded below. 



.EXTN .CTB 



;.CTB MUST BE DECLARED 



LDA 


1, CN3 


START: JSR 


@CTB 


PRMPT*2 


| IBUF 


*2 


I 300 




CT 




STRT 


SUBZ# 1, 0, SNC 


JMP 


START 


STA 

* 


0, TO, 3 


CN3: 


3 


CTB: 


.CTB 


PRMPT: 


.TXT /**<15>/ 


IBUF: 


.BLK 140 


CT: 


. BLK 140 


STRT: 


"A 




"B 




,, c 




"D 




-1 



LOAD COMPARAND 

CALL CT BUILDER 

BYTE ADDRESS OF PROMPT MESSAGE 

BYTE ADDRESS OF INPUT BUFFER 

MAXIMUM COMMAND LINE LENGTH 

COMMAND TABLE ADDRESS 

TRANSLATE TABLE ADDRESS 

3 OR MORE TABLE ENTRIES? 

NO. RE-PROMPT 

YES. SAVE COUNT IN STACK 



;ONLY 4 SWITCHES RECOGNIZED 
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NAM£j paRU.SR PART NUMBER! 09§-§§i883 

revision n?s?osvi 

REV. DATE 

00 07/25/72 

Pi 1 12/20/72 

02 06/15/73 

&3 11/30/73 



COPYRIGHT CC5 DATA GENERAL CORPORATION, 1972, 1973 
ALL SIGHTS RESERVED, 

LICENSED MATERIAL - PROPERTY OF DATA GENERAL CORPORATION. 
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I ROOS »EVTSIOM «3 USER PARAMETERS 



I DEFINE THE CLI STACK DISPLACEMENTS 



.DUSP 


SSLGTb 


-7 


I 


.DUSR 


ssosp« 


-6 


f 


.DHS» 


S$RTN« 


• 5 


I 


.DUSR 


SSEAD* 


-4 


I 


.DUSP 


SSCRYb 


-3 


1 


.OUSP 


s$Ace* 


-2 


t 


.dusr 


SSACX" 


-i 




.OUS» 


SSAC2" 


9 


1 



VARIABLE LENGTH OF CALLINGS FRAME 

PREVIOUS STACK POINTER 

RETURN ADDRESS OF CALLING PROGRAM 

ENTRY ADDRESS OF CALLED ROUTINE 

CARRY 

SAVE STORAGE FOR CALLING'S ACCUMULATORS 

(DON'T HODIFY THIS DISPLACEMENT 1 1) 
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I 

I UFT EwTRY 

I 

I USER FILE DEFINITION (UFO) OF tjFT 

S DUSP HFTFNaPi IFILE NAME 

,DU5R UFTEX«^ fEXTENSION 

g nij?P ijFT&Tsfi I FILE ATTRIBUTES 

.DUSR UPTL<«7 ILINK ACCESS ATTRIBUTES 

.DUSR UFLADa? ILINK ALTERNATE DIRECTORY 

.OUSR uftbk»J3 f NUMBER OF LAST BLOCK IN FILE 

.OUSR MFTRCbH INUMBER OF BYTES IN LAST BLOCK 

.OUSR iJFTA0«12 IDEVICE ADDRESS OF FIRST BLOCK (0 UNASSISNID5 

.OUSR UPTAC*t3 iyFAR-DAY LAST ACCESSED 

.OUSR !)FTY0»14 IYEAR-DAY CREATED 

.OUSR UFLAN»14 film ALIAS NAME 

.PUSR UFTHMalS f HOUR-HI NUTE CREATED 

.DUSR UFTP1al6 rUFD TEMPORARY 

.OUS» UFTP2»17 ! " " 

.DUSR 1JFTIJC«28 IUSER COUNT 

.PUSR UFTDL"2l *DCT LINK 

I DEVICE CONTROL BLOCK (DCS) OF UFT 

.DUSR UFTDC»22 FDCT ADDRESS 

.DUSR UFTUN»23 JUNIT NUMBER 

.DUSR UFTCAi24 fCURRENT BLOCK ADDRESS 

.DUSR UFTCBa?5 JCURRENT BLOCK NUMBER 

.DUSR UFTSTs26 JFILE STATUS 

.DUSR UFTEA8P7 rENTRY'S BLOCK ADDRESS 

.DUSR HFTNA«3P ?NExT BLOCK ADDRESS 

.DUSP UFTLA-31 >LAST BLOCK ADDRESS 

.DUSR UFTDR«32 ISYS.OR DCB ADDRESS 

.DUSR HFTFA«33 ?FIRST ADDRESS 

? DC8 FVTENSION 

.OUSR UFTRMb.34 fCURRENT FILE BLOCK NUMBER 

.DUSR UFTBP»35 ^CURRENT FILE BLOCK BYTE POINTER 

.DUSR UFTCH«36 fOEVICE CHARACTERISTICS 

.OUSR UFTCN»37 ^ACTIVE RED COUNT 

fBO INDICATES 0, i«DSQl , 1 «DSQ2 

.DUSR UFTEL»UFTCN-UFTFN4l fUFT ENTRY LENGTH 
.DUSR tlFDEL^UFTDL-UFTFN+t JUFD ENTRY LENGTH 

.DUSR IJOBATslJFTAT-UFTDC JNEGATIVE DISP. TO ATTRIBUTES 

.DUSR HDBADiUFTAD-UFTDC *NEGAVIE DISP. TO FIRST ADDRESS 

.DUSR UDRBKbUFTBK-UFTDC INEGATIVE DISP. TO LAST BLOCK 

.OUSR tlDBBM»IJFT^N-UFTDC fPOSITlVE DISP. TO CURRENT BLOCK 



C-3 



FltF fiTI-M^.^ES 



UU5R ATRP ■115^ 

U 5 « A T C H A a t h t 

OUSR 4TSAValB? 

niJSP ATNRSai»7 

•)il$R ATUS1 a J ft 9 

DUSR ATiJ$?a}8t0 

01? 5» j*TP£(?»}^14 

OUSR ATWP a 131 5 



ICNAWQE ATTRIBUTE PROTECTED 

ISAVED FILE 

JCANNDT BE A RESOLUTION ENTRY 

IUSEP ATTRIBUTE * 1 

RISER ATTRIBUTE * 2 

IPEPMAMEMT FILE 

INCITE PROTECTED 



FILE CHARACTERISTICS 



.dusr 

.DUS» 

.DUSR 
.DUSP 

.OUSR 



ATLNKalB3 

ATPA»alrt4 

ATniR*185 

AT«r,S«lB6 

ATOIOsiSB 

ATC0N«1B12 

ATRAN«1B13 



ILINK ENTRY 
iPARTITIHhi ENTRY 
IDIPECTOPY ENTRY 
ILINK RESOLUTION 
IDIRECT I/O ONLY 
I CONTIGUOUS FILE 
?RANDOH FILE 



(TEMPORARY) 



DEFINE SWITCHES 



.DUSP 

.OUSR 
.OUSR 
.DUSP 
.OUSR 
.OUSR 
.OUSR 

.ouss 

.nu$R 

.OUSR 

.DUSP 
.OUSR 
.husr 

.OUSR 

.pusp 

.OUSR 
.DUSR 
.DUSR 
.OUSP 
.PUSR 
'.PUSR 
.OUSP 
.DUSR 
.PUSR 
.OUSR 
.DUSR 



,sw« 

, S *i 8 

„ S w a 
, S w a 
, S W a 
, S w ■ 
.Swa 
, S'w a 
, SWa 

• Sw« 
. SNa 

.s^« 

, Sw« 
, Si* a 
. SWa 
, S W a 
.SWa 
,Swa 
. $ W a 
,SWi 
, S * a 

,SWB 

.Swa 

,Sw» 

, S W a 

, SW« 



ia&3 

1. 301 

1802 

1BPI3 
1B^4 
18CT5 

1B07 
18^8 
1B0)9 

ieic 

1911 
1812 
1813 
1814 
IBIS 
1BPW 

iBcn 

1802 
1BP3 
1BPU 
1SC*5 
1B06 
1BPS7 
1 8W8 
1B^9 
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C y S T » 



. D t ' S R 


. D U 5 R 


. f j u s r 


. Dl'SP 


• L " ^ R 


.ousr 


. ^ ».-' s 5? 


,LjUS» 


.OUSR 


.OUSP 


.ousr 


.OUSR 


. OUSP 


.ousp 


.OUSP 


„ U S R 


.OUSt? 


.PUS R 


.OUSP 


.OUSR 



S C *< P '"* s o *> 5 # 
50t-Sa?5£. 
S C L L j s i 3 ? . 

* C F M. « '-' F T £ x - 1 i F T F ^ + 

S C v - E * = 1 -" * 

«s r T T M - . * •/ b 
S C K S s *? 5 

S C P P L a F*« 

S C S V S a 

S C P N M a 4 

SC&PBsSCSYS+l 
.SrFPB«SCSPB + SCPNM 

SCHXTaljFTEX-UFTFN 

SFINTal&i* 

S F R R K * 1 8 I 5 



*<«n»ns PER BLOCK 
SIZE OF DISK 8L0CK 
MAX LINE LENGTH 
MAX ARGUMENT LEN6T 
IFILE NAHE LENGTH 
max EPROP RETRY CO 
SAVE FILF STARTING 
RInGIO 1 MS. LOOP 
M.;yR£R nF $¥ST£H 
PRIMARY PAPTITQN L 
pS?J«AR¥ PARTITJ^N 

SYS. DP ADDRESS OFF 
MAX NUMBER OF PUSH 
RELATIVE BACKROUND 

WFLATIVF FOPEGRQUN 
RELATIVE BASE ADDR 
EXTENSION OFFSET I 
wO»D5 PEP RANDOM R 
INTERRUPT FLAG 
BREAK FLAG 



H IN BYTES 

UNT 
ADDRESS 

TI^E (SN) 

VERLAVS 

EVEL 

BASE ADDRESS 

SET 
LEVELS 
PUSH BASE 

D PUSH BASE 

ESS OF MAP, OR 

N NAHE AREA 

ECOPO 



; DEFINE SYSTEM BOOTSTRAP CONSTANTS 



.OUSP 

.PU5P 
.OUSP 
.OUSP 
,OU$P 
.DUSP 
.PUSC 
.OUSP 
.DUSS 5 
.OUSP 
.OUSR 
.DUSP 
.DUSP 
.QUS& 



SCT&P 

SCPUL 
SCPSA 
SCPAR 

8 C P V 
SCCLI 
SCZMX 

SCCPL 
SCPBA 
SCOFA 
SCKEY 
SCUM 
SCBAS 
$ C I D V 



a 91 

sSCT8P+l 

• 2 

sSCFUL+l 

sSCPAP-H 

sSCPOV*! 

■SCCLX+t 

■sczMy+i 

■SCCPL+l 

aSCPBA+t 

■scnFA+1 

sSCKEY+i 
■ SCUM + i 

s2t* 



TEXT STRING BYTE POINTER 
FULL INIT INDIRECT 
PROGRAM START ADDRESS INDIRECT 
PARTIAL INIT ADDRESS INDIRECT 
PARTIAL WITH OVERLAYS INDIRECT 
ADDRESS OF END OF CLI CONSTANT 
SQUASHED/UNSOUASHED FLAG 
CURRENT PARTITION LEVEL 
PARTITION BASE ADDRESS 
ovERLA¥ F | LE b4 S e ADDRESS 

MASTER DEVICE KEY 
MASTER DEVICE UNIT NUMBER 
BASE OF INFORMATION BLOCK 
INITIAL DEVICE CODE 
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F e & • P- 



_ '••>*£ 


J. 3 J? s -■ , 


« 


;■"■%■: 


?:.*- .«* 


I 


3 ; *~ 


E - 1 C • s 


ft 


8 ous c 


^TCC-a 


It 


,ous& 


FPC.Vis 


«£ 


.DIJSR 


r C w » ? a 


w 


,= ; <* c 


V £ S" ^ S € 


»•-» 


# *^ ^ v ■ : - 


p ^ -. D - » 


7 


.: js- 


^ £ „ -* ; f 


J B 




: _, - v Cf g 


1 1 


dijsr 


~ -"■ "" .. ' -* 


1 2 


. , , « ~z 


r ~ ' ' *f 


j 3 


DUSR 


£ ^ *; * l s 


14 


f -';';?,& 


- 5 >* " ? 3 


15 


„ V- : sr 


E-.'.F^s 


*! 


,«j»;ss? 


E^LlIs 


22 


9 5<J5» 


fc' S » T M 3 


83 


.C ! JS° 


PR-4P2 


JM 


.dusr 


ERCn3s 


2 5 


.OUSR 


E C H P H 3 


26 


.UUS a 


ERSPC" 


?7 


* h u s r 


E & ~ 1 1. * 


30 


. n Li s © 


"PS Els 


31 


*>>«!$» 


r y 4 ij 3 S 


32 


.ousp 


E R P f l a 


33 


. n y s y 


ephios 


34 


„ D U S P 


ERMTRa 


35 


.';USR 


C ^D^B 


36 


« '.'• i • * ^ 


E k v M ■ 


37 


.:- ! . { sr 


PRHVAs 


4ft 


,'JL'SR 


F r t j m 3 


41 


.■H^P 


EoNQTs 


4? 


» U S P 


F M X M T a 


43 


.OUSR 


?5Sn p 2 


44 


.•vsp 


?5}L-?!5 


45 


.'MJSR 


F-IC R s 


46 


.OUS» 


PRSIHs 


47 


, o u s y 


* ^ r J T 3 s 


5« 


.ous=> 


F p Ki tf. (3 g 


5! 


. 1J S R 


* JC 1 O S a 


52 


»r.»«s» 


E » S M s 


53 


„Oi <>.>»« 


Pv.')J?3* 


54 


.OUSR 


-n-nc^.s 


S5 


.OUSP 


^'!M i_,a 


•?6 


. «~ • « S R 


h.»L:-F^ 


57 


• * < ;i * '* 


'-^FlUa 


«<a 


% * i! iS? 


TsTT^a 


61 


.onsc? 


•KfM^K 


«2 


.OUSR 


P :-? C ,J S 8 


^3 


s nnsp 


KS'^P S 


64 


. : : " - s «* R 


F P D C H a 


65 



r '•_ ^ r 1 a l s i t E ^' A ," E 

'. ■ . . *> ■ . ■'. v ^'^^ COMMAND 

illegal cohmano for^ device 

MOT k SAVED FILE 

i ?TF _HPT TO ^RITE AN EXISTENT FILE 

EK.^- OF FILE 

4TTENP? TO READ A READ PROTECTED FILE 

^'RTTE PROTECTED FILE 

ATTEMPT TC CREATE AW EXISTENT FILE 

A ^C^-FylSTEMT FILE 

AT -fM.pr to ALTER A PERMANENT FILE 

ATT*T8mTES PROTECTED 

c ILt NOT OPEMEH 

4TTEMPT TO USE A UFT ALREADY IN USE 

LINE LTHIT EXCEEDED 

ATTEMPT TO RESTORE A NON-EXISTENT IMAGE 

PARITY ERROR ON READ LINE 

TRYING TO PUSH TOO MANY LEVELS 

^OT ENUF NENORY AVAILABLE 

OUT OF FILE SPACE 

FILE READ ERROR 

UNIT NDT PROPERLY SELECTED 

ILLEGAL STARTING ADDRESS 

ATTEMPT TO READ INTO SYSTEM AREA 

PILE ACCESSIBLE BY DIRECT I/O ONLY 

FILES SPECIFIED ON DIFF. DIRECTORIES 

DEVICE NOT IN SYSTEM 

ILLEGAL OVERLAY NUMBER 

FILE NOT ACCESSIBLE BY DIRECT I/O 

USER SFT TIME ERROR 

OUT OF TCB'S 

SIRNAL TO BUSY AODR 

FILE ALREADY SQUASHED ERROR 

DEVICE ALREADY IN SYSTEM 

INSUFFICENT CONTIGUOUS BLOCKS 

QTY ERROR 

ERROR IN USER TASK QUEUE TABLE 

NO NORE OCB'S 

ILLEGAL DIRECTORY SPECIFIER 

Directory specifier not known 
directory is too small 

DIRECTORY DEPTH EXCEEDED 
DIRECTORY IN USE 

LINK DEPTH EXCEEDED 

FILE IS IN USE 

TASK ID ERROR 

COMMON SIZE ERROR 

COMMON USAGE ERROR 

FILE POSITION ERROR 

INSUFFICIENT ROOM IN DATA CHANNEL MAP 
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.DUSR 


ERONl« 


66 F 


.nusR 


EP>'DO« 


67 I 


,!.";USR 


FPFGE» 


70 F 


.PUSR 


ERMPT* 


71 f 


.OUSR 


EPOPDs 


72 F 


.OUSP 


E*U5Z« 


73 I 


.OUSR 


EPHPRb 


74 F 


.DUSR 


EPNLEs 


75 I 


.OUSR 


EPNTE* 


76 F 


.OUSP 


EftSDE* 


77 r 


.OUSR 


ERMDE" 


10P» F 


.OUSR 


EPOTOb 


101 F 


.OUSR 


EREnAs 


102 F 


.OUSP 


EPMCAa 


1*3 F 


.OUSP 


EPSPRa 


104 F 


.OUSP 


ERSDL« 


10 5 F 


.OUSR 


erclo* 


106 F 


.OUSR 


ERSf A« 


107 F 


.DUSR 


ERABTa 


11* F 



DIRECTORY NOT INITIALIZED 

NO DEFAULT DIRECTORY 

FOREGROUND ALREADYS EXISTS 

ERROR IN PARTITON SET 

DIRECTORY IN USE BY OTHER PROGRAM 

NO ROOM FOR UFTS ON EXEC/EXFS 

AOOR ERROR ON .SYSTM PARAM 

WOT A LINK ENTRY 

CURRENT B5 IS NOT CHECKPOINTABLE 

SYS. OR ERROR 

HAP, OR ERROR 

DEVICE TINE OUT 

ENTRY NOT ACCESSIBLE VIA LINK 

MCA REQUEST OUTSTANDING 

INCOMPLETE TRANSMISSION CAUSED BY RECIEVER 

SYSTEM DEADLOCK 

I/O TERMINATED BY CHANNEL CLOSE 

SPOOL FILECS3 ACTIVE 

TASK NOT FOUND FOR ABORT 
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I DEFINE THE CLI ERROR COOES 



.UU$R 
,OfS» 
.00 s» 
.nusp 

.OUSP 
.DUSR 

.DUSP 

»DUS» 
.OUSP 
.OUSP 

.dusp 

.I.UISP 

.DUSP 
.DUSP 

.DUSR 
.DUSR 



CNEAR»3t5(8 

C I L A T a 3 «! ! 

0NDBn«392 

CNCT0«3'?3 
CN8AD»3M 

CCKFR»305 

CNACMs3n7 
CILBK»3J(* 
CSPER«3l 1 

CPHER83I2 
CTMAP"313 
CTMAD*3|4 
CILNAs3i5 
CSFUE*3I6 
CRAP«317 
CCANT«32Pi 



INOT ENOUGH ARGUMENTS 
ULtFGAL ATTRIBUTE 

r^ debug; address 

$^ n CONTINUATION ADDRESS 

INO STARTING ADDRESS 

FCHECKSUM ERROR 

INO SOURCE FILE SPECIFIED 

fNOT A COMMAND 

IIIIEGAL BLOCK TYPE 

IkQ FILES MATCH SPECIFIER 

IPHASE ERROR 

ITOO MANY ARGUMENTS 

fTno MANY ACTIVE DEVICES 

I ILLEGAL NUMERIC ARGUMENT 

IFATAL SYSTEM UTILITY ERROR 

IILLEGAL ARGUMENT 

riMPROPEP OP MALICIOUS INPUT 



.DUSP CC*AX*CCANT 

.UU3P EPML«2^. 

I DEFINE THE PANICS 



JMAX CLI ERROR CODE 
^MAXIMUM ERROR MESSAGE LENGTH 



.DUSR 


PNMREs 


#1 


.QUSR 


PNSDEa 


#2 


.OUSP 


PNCSO« 


■3 


.DUSP 


PNIDA« 


#4 


.DUSR 


PNMDDs 


*5 


.DUSP 


P N M D T ■ 


$6 


.DUSP 


PNOPE« 


97 


.DUSR 


PNCUI" 


#10 



t MAP.DR ERROR 

I SYSTEM DIRECTORY ERROR 

f SYSTEM STACK OVERFLOW 

t INCONSISTENT SVSTEM DATA 

f MASTER DEVICE DATA ERROR 

? MASTER DEVICE TIME OUT 

r MOVING HEAD DISK ERROR 

? UNCLEARABLE UNDEFINED INTERRUPT 
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7 OFFICE TNF DFVICP CHARACTERISTICS 



.UUSR 

.->U.S» 

.OUSR 

.DU5R 

.OUSR 

.DUSP 

. o u a r 
.ous» 

. ! jUS» 
.OUSR 
.0U5P 
.DUSR 
.DUSR 
.OUSR 
.PUSR 
.DUSR 



n n c p c s 
n c c n f « 

OCTQa 

n c k t* y ■ 

DCNAFb 
D C * a T ■ 

DClACs 
D C S P = 
OCFWD" 

DCFFOb 
DCLTlja 
n C C 6 a ■ 

ocDins 
n c s p c ■ 



18 5 5 

I'M 5 

1814 

IB13 
1B!2 
1811 
181PI 

1809 
1B^8 
1B^7 

1B04 
IBW3 

1BP51 

IB«0 



DEVICE REQUIRING 
"SEP SPECIFIED T 
G9APHITAL HUTPUT 

HARDWARE. 

Input oevice req 

OUTPUT DEVICE Wl 
TELETYPE OUTPUT 
XEVBHAPD DEVICE 
OUTPUT DEVICF R£ 
RUB0UT5 AFTER TA 
DEVICE REQUIRING 
REOUIRES LINE FE 
SPOntARLE DEVICE 

full word device 

FQRH FEEDS ON OP 
CHANGE LOtaER C&S 
READ 80 COLUNS 
SUSPEND PROTOCOL 
SPOOL CONTROL 
SET ■ SPOOLING E 
RESET c SPOOLING 



LEADER/TRAILER 
IME OUT CONSTANT {NCA) 
DEVICE WITHOUT TABBING 

UIRING OPERATOR INTERVENTION 
THOUT FORM FEED HARDWARE 
DEVICE 

QUIRING NULLS AFTER FORN FEEDS 
BS REQUIRED 

PARITY CHECK 
FDS AFTER CARRIAGE RTN 

(ANYTHING GREATER THAN 
EN 
E ASCII TO UPPER 

ON TRANSMIT (MCA5 

NABLED 
DISABLED 
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, « tr » ' ? A *. *• '* 4 s > 



uE (US*) T E v *LATr 



. DLISP UST* 4P| 



I ST43T OF ?AC*G»OUNO USER STATUS AREA 



.ousb 

.DUSR 
.OUSR 

«nus» 

.DUSP 
.OUSP 
.OUSR 

.ousp 
.ous» 

.OUSP? 
.DUSR 

.ous» 

.DUSR 

.DUSR 
.OUSP 
.OUSR 
.OUSR 
.DUSR 
.OUSR 



U S T P w 1 9 
IjSTP m UST 



CORRESPOND TO 



OC FOR UST 
PARS PZERO 



POINTER 
ALLOCATIONS 



U$ T PC a 

1 ! S T J M s 

USTSS* 
» ' S T £ S s 
n 5 T ft' * x 
UST$A* 
» > ,* T *> A ^ 
"JSTHi b 
USTCSs 
USTIT» 
USTBPs 
USTCHs 
U S T C T s 
USTACs 
USTFCs 
USTINe 
USTODa 
USTSVa 
USTEMs 



.OUSR UFPT 



- 

2 

3 

4 

5 

ff 

7 

18 

li 

12 

13 

14 

15 

16 

17 

21 
USTSV 

3CJ 



7 w a x 

START OF SYMBOL TABLE 
END OF SV*90L table 

NMAX 

STARTING ADDRESS 

DEBUGGER ADDRESS 

HIGHEST ADDRESS USED 

FORTRAN COMMON AREA SIZE 

INTERRUPT ADDRESS 

BREAK ADDRESS 

» TASKS (LEFT), * CHANS (RIGHT) 

CURRENTLY ACTIVE TCB 

START OF ACTIVE TCB CHAIN 

START OF FREE TCB CHAIN 

INITIAL START OF NREL 

OVLY DIRECTORY ADDR 

FORTRAN STATE VARIABLE SAVE ROUTINE 

LAST ENTRY 

f SAVE SOS 



(OR 0) 



DEFINE TASK CONTROL BLOCK (TCB) TEMPLATE 



OUSR 
OUSR 

nu$p 

OUSR 
OUSR 

OUSR 
U S R 



TPCa 
T A C ■ 
TACl» 
TAC2» 
T A C 3 * 
T P P S T ■ 
T S Y S ■ 



OUSR TLNKs 

OUSP TIjSPs 

OUSR T E L N ■ 

U 1 J S P T I D s 

OUSR TTMPa 




1 
2 

3 

4 

5 

« 

7 

10 

11 

12 

13 



IUSER PC + CARRY 

1 AC? 

^ACl 

I AC2 

t AC3 

ISTATU 

ISYSTE 

ILINK 

FUSP 
fTCB E 

ITASK 
ISCHED 



S BITS CLEFT BYTE) ♦ PRIORITY (RIGHT BYTE) 
H CALL WORD 

WORD 



XTEMTION ADDR 

ID 

ULER TEMPORARY 



.OUSR TLNsTTMP-TPC+1 



FLENGTH OF TC6 



I DEFINE TASK STATUS BITS 

I 

1 IBP ■ TASK P ENDED 

; i-n a WATTT^P FOP OVERLAY AREA OR '.XMTW/.REC 

I H? g SUSPENDED 

F 1H3 a WATTING FOR .TROOP (READ OPERATOR INPUT) 
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f 

I DEFINE OVERLAY NODE TABLE 
I 



IDIRECTORY NODE TABLE START 
fCURRENT OVL¥#USER COUNT 
JNUHBER OF OVERLAYS CLEFT BYTE) 
IS11E IN BLOCKS (RIGHT BYTE) 

ISTARTINS BLOCK 
ICORE AD^R FOR KQDE 

QUEUE TABLE 

t s T a » t i >, r, pc 

INUNBER OF TIMES TO EXEC 
fOVERLAY 
ISTARTINR HOUR 
ISTARTING SEC IN HOU* 
INUST BE SANE 
IRERUN TINE INC IN SEC 
fMUST BE SAME 
rCHAN OVERLAYS OPEN ON 
ITYPE OF LOAD 
.DUSR OTLN" QCONO-OPC*! 



.OUSR 


OVNOS«P« 




.DUSR 


OVRES»l 




.DUSR 


0VDIS«2 




,OUSR 


OVBL»<«3 




.DUSR 


0VNAD«4 




I offsets for user ta 


.OUSR 


QPCs 


Pi 


.OUSR 


ONUMs 


i 


.OUSR 


OTOVi 


P 


.OUSR 


OSH« 


3 


.OUSR 


QSMS» 


4 


.OUSR 


QPRI" 


TPRST 


.OUSR 


ORR« 


6 


.OUSR 


OTLNK* 


TLNK 


.DUSR 


OOCH« 


10 


.OUSR 


QCONO» 


11 



.EOT 



Oil 



I ALL SIGHTS RF.SERVFH, 



C^' = r 'r; r i. "J"!, 1973 



f 
I 
I 

F 

.0U5P 
.OUSP 

.ousp 

.OUSft 
.OUSP 
.OUSP 
.OUSP 
.OUSP 
.OUSP 

.ousp 

.OUSP 
.OUSP 

? 

.OUSR 
.OUSP 
.OUSR 

.OUSR 
.DUSP 
.DUSP 
.DUSP 



SOS PARAMETERS 



S A V F » 
P T P N s 

PTLOD 

AC** 

ACIb 
TK-Pi 
SL&T« 

A C 1 ■ 

OTHPs 

n p t n 8 

SSZb 



PLOC» 

C M S K ■ 
CSP« 

COCTa 
BpCTa 
CaC^s 
CACj s 



LINKAGE 

JSP »3 
JMP #4 
01 

1 

? 

3 
TMP*| 

AC0-SLGT 

AC1-SLGT 

TMP-SLGT 

RTLOC-SLRT 

6. 

NFPAM*SLGT 

PAGE ZERO 



7 

10 
11 

13 

14 
15 



f IN SERVICE OCT 
^BEGINNING OF DCT CHAIN 



ADDITIONAL UST DEFINITIONS 

.DUSP USTA0B 20 

.OUSR USTAls USTAfl+1 

.LHJSP U$TA?» USTA1 + 1 

.OUSR USTA3" USTA2+1 

.OUSR USTC^a USTA3+1 

.OUSR USTIS= USTCY+1 

.OUSP USTWA" USTIS+1 

.OUSR USTPSs USTWA+1 



.OUSP 



ADDITIONAL DEVICE CHARACTERISTICS 
DCDIPs 1B« ? SOS DATA CHANNEL DEVICE 
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f DEVICE CHMPOL TABLE (DOT) LAYOUT 
f C . — "■• v~ »,. , r-t VICE'S 

.OUgR HCTCOa 01 f OFVICE CODE 

.OUSP HCTHSa 1 f NASK OF LOWER PRIORITY DEVICES 

fOEFlME THE *A5K BITS 

.DUSR HSTTOs 1315 

.DUSR HSTTI« IBM 

.CUSP HSPTPb 1813 

.OUSP NSLPTb iB!2 

.OUSP NSCDPo 1 b i w 

.DUS» MSPLTe 1612 

.DUSR MSHTAa 1B10 

.DUSR NSPTRs 1BI1 

.DUSR DCTCHs 2 f DEVICE CHARACTERISTICS 

.DUSR DCTLKs 3 » I LINK TO NEXT OCT 

I CJ TERMNATES THE CHAIN) 

.DUSR OCTIS" 4 | INTERRUPT SERVICE ROUTINE ADDRESS 

.OUSP DCTILs 5 f INTERRUPT MACHINE STATE LINK 



.DUSP DCTDT* 6 f CQMNAND DISPATCH TABLE ADDRESS WORD 

.DUSR DCTST. 7 i ADDRESS OF DEVICE START ROUTINE 

.DUSR DCTSPs ie l ADDRESS OF DEVICE STOP ROUTINE 

.DUSR DCTFLs 11 f FLAGS (ACTIVE, ATTACHED, ETC.) 

; DEFINE THE" FLAGS 

.DUSP DCACT* IB i 5 I ACTIVE FLAG 

.DUSR DCACPT« IB* t ACCEPT CHARACTER FLAG 

.DUSR DCKMDb 160 f TTY KEYBOARD MODE FLAG 
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I COMMON Tr - P i-':C*T?:« ^r,—>~ ' ?,r. SI*&lF l«S£»/SINGLE BUFFER) 

*\v\r -"--,f- -- I ' -_ - — ■ * I -'ST «.^-vr 5S (flwTF ) 

*0U*» .rT*L« 14 f '•:*""? „A«T AD09ESS 

.OUSR OCTIPe 15 I BUFFER 1 ^ P I ! T POINTER C8¥TE ) 

1dUS» PCTCPa |6 I B'jFFEP OUTPU POINTER 

,»H'3P ^cTCNa I? I *r ! ^T "«F ACTIVE DATA 

*0«)S» ^ CTT «» 2i I ?|N£n=jT wc^D CALL INPUT DEVICES) 

louse- n C ?CC= 2« I CO' ; J^- CCU7E* (ALLPUTPUT DEVICES) 

.OUSR ncT-^C* r *\ 1 -FSTAPT CONSTANT (ALL INPUT DEVICES) 

* I«3P ncTi.Cs 21 I L'X*-i£ COUNTER CALL HUTpiJT OEVTCES) 

'iJL'SR OCTATs ?2 ? r "~V'ICE iT'OIBUTES 

.DUSP ^C T? ts 23 tOEvlCE FI^S^ CHARACTERISTICS 

.O'ISP LCHNO« 6 P LOWEST lESAL CHANNEL * 

.PUSR HCHN^a 3? f HIGHEST LEGAL CHANNEL » 

! NOTE » ONE OP BOTH OF THESE EQUI- 

I VALENCES MAY BE CHANGED TO ADD 



f DEVICE DRIVERS 



? H4R TAPE PARAMETERS 



.OUSR HTBWZ» 377 fSUFFEP NOPD SIZE 

,OUSP MTBSZs MTBWZ*? fBUFPEP BYTE SIZE 

.OUSR CTBWZ» MTBW7 

.DUSR CT«*7a MTBBZ 



I INTERRUPT PRAHF TEMPLATE 

.OUSR IAC0« DCTFC+i 

,OUSR IAC1" IAC5S + 1 

.OUSR IAC2» IACl+a 

.OUSR IAC3* IAC8*i 

.DUSR IPC= IAC3+1 

.OUSR IRLOCs IPOl 

,OUS» IMSK« IRLOC*! 

.OUSP IFRL« 7 UNTEPPUPT FRAME LENGTH 

.EOT 
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1 ALL SIGHTS RESERVED, 



^R50»A T ICK.-, 1972, 1973 



ISOS US£P APPLICATION PARAMETERS (PAPUA) 



FSTACK DISPLACEMENTS 



.DUSR 

.oljsp. 

.QU$R 
.DUSP 
.DUSR 
.DUSP 
.OUSR 
.DUSR 
.DUSP 
.DUSP 
.OUSR 
.DUSP 
.DUSR 
.DUSP 



.DUSR 
.DUSR 
.DUSR 
.DUSR 



.DUSR 
.DUSR 
.DUSP 
.DUSR 
.DUSR 
.DUSP 
.DUSP 
.DUSP 
.DUSP 
.DUSP 
.DUSP 
.DUSP 



SSEL* 

SOSEC* 

RTR» 

TPI« 

Tl« 

SACP» 

SAGS* 

SAC2s 

DAC^a 

OACl« 

0AC2» 

ORTR« 

OT?*« 

DTI* 



1 
2 
3 
A 

SAC^-SSEL 

SAC1-SSEL 

SAC2-SSEL 

RTR-SSEL 

T0-SSEL 

T1-8SEL 



FEVTRY LENGTH 

fENTRY COUNT FOR SOS USER ROUTINES 

/FRAME LAYOUTS 

I RETURN LOCATION 

f TEMPORARIES 

I SAVE ACCUMULATORS 



fTHESE DISPLACEMENTS PERMIT 

I "CALLEE" TO SET AT "CALLER'S" 

I REGISTERS 



ICOMMAND TABLE DISPLACEMENTS 



CTBP« 

CTSWb 

CTNBPi 

CTEL» 



ICOMMANO TABLE SWITCHES 



sw^« 

SWli 
SW2« 
SW3« 
SW4« 
SK»5» 
SW6« 

SW8« 

SW9» 

swim 
swn« 

.EOT 



1B0 
IB1 
182 
1B3 
IB* 
IBS 
1B6 
1B7 
IBS 
1B9 

1BM 



FSTRING BYTE POINTER 
ISWITCH WORD 

JNEXT STAPTING BYTE POINTER 
IENTRY LENGTH 



t EACH OF THESE BIT SETTINGS 
fMAY BE EQUIVALENCED TO A MEAN- 
FINGFUL VALUE IN THE USER APPLI- 
CATION PROGRAM, THE ARRANGEMENT 
fpF THg fRANSLATE TABLE (tpt1 

IDETERMINES THE PRECISE MEANING 
fOF EACH SNITCH. 
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INDEX 



■id) 3-7, 3-8 



3-13 



( \ ) 



— { REDOUT) 3-8 

( , , , ) in command line 3-13 

(form feed) 3-8 
* editor prompt 3-42 
« CILW prompt 3-5 

.ACHR A -31 

adding device handlers App. A 

APPEND 3-18 

ASM 3-42 

assembler 

command 3-42 

configuring 5-7 

on master reel 5-12 

BOOT 3-19, 1-3 

bootstrapping C ILW 3 -4 

BPUNCH 3-20 

break (CTRL A, CTRL C) 3-2 

byte 

load A -33 

pointer 4-4 

store A -32 

card reader 2-1, 4-27 
cassette 

configuring utilities for 5-8 

file protect tab 2-4 

files 2-4 

physical characteristics 2-4 

response to SOS 4-28 

tape library 1-1, 2-3 

tapes supplied for 5-1 to 5 -3 
SCDR 2-1, 4-27 
CDRDR ( . CDRD) 2 -3 
channel number to device map A -17 
channel n umbers 

list of fixed for standard SOS devices 2-1 

range 1-2 
character 

getting {. G CHAR) 4-17 

putting (.PCHAR) 4-17 

reading (.RCHR) A -30 

sending { . ACHR) A -31 
CILW (see core image loader/ writer) 
CLI (see command line interpreter) 
.CLOSE 4-10 
. CLS routine A -28 
command delimiter (;) 3-8 



switches 
command line interpreter 
activation 3-7 

command descriptions 3-18 ff 
definition 1-3, 3-7 
list of commands 3-17 
messages from 3-14 ff 
on master reel 5-10 
prompt (R) 3-7 
symbols and conventions 3-8 
command table b uilder 2-3, App. 
commands (CLI) 
APPEND 3-18 
BOOT 3-19 
BPUNCH 3-20 
COPY 3-21 
DEB 3-22 
DUMP 3-23 
FILCOM 3-25 
GTOD 3-26 
EXIT 3-27 
LOAD 3 -28 
MKA3S 3-30 
MKSAVE 3 -31 
PRINT 3-32 
PUNCH 3-33 
RELEASE 3-34 
SDAY 3-35 
STOD 3-36 
TYPE 3-37 
XFER 3-38 
commands (system) 
.CLOSE 4-10 
.DELAY 4-21 
. EOPEN 4 -8 
.GCHAR 4-17 
.GCHN 4-9 
. GDAY 4-20 
.GHRZ 4-22 
. GTATR 4-5 

• GTOD 4-20 
.IDEE 4-22 
.IRMV 4-23 
.MEM 4-18 
.ME Ml 4-19 
.OPEN 4-8 
.PCHAR 4-17 

• RDL 4-10 
.RDS 4-12 



INDEX -1 



INDEX (Continued) 



commands (system) (continued) 

.RESET 4-10 

. ROPEN 4-8 

, SDAY 4 -21 

.STOD 4-20 

.SYSI 4-4 

. SYSTM 4-1 

,WRL 4-15 

. WRS 4-16 
communicating with SOS 1 -3 
configuring SOS Chapt. 5 

configuring for cassette/mag tape 5-8 

configuring for paper tape 5-6 

configuring utilities 
assembler 5-7 
FORTRAN IV 5-14 

other utilities 5-6 
core image loader/writer 

bootstrap 3 -4 

or 4 .'••:]'.'■; ; - -v 

definition 3-4 

error conditions 3-5, 3-6 

installation 3 -4 

on master reel 5-9 

operation 3-5 ff 

prompt (#) 3-5 

versions 3-4 
core 

available to user 1-5,1-6 

determining available 4-18 

requirements 1-1 
CTA (cassette) 4-28 
CTADR (.CTAD) 2-3 
CTB(. CTB) 2-3, 5-5, App. B 
CTRL A 1-3, 3-2 
CTRL C 1-3, 3-2 
CTRL L 3-7 

CTU1 -CTU7 (. CTU1 -. CTU7) 2 -3 
CT0-CT7 2-1 

OCT A -10 

DEB 3-22 
.DELAY 4-21 
device 

definition 2 -1 

list of 2-1 
device control table (DCT) A -10, A -3 
device dispatch routines A -24 
device handler 

adding App. A 

approaches, table of A -8 
device start routine A -23 
device stop routine A -23 
. DISM routine A -33 
DUMP 3-23 



EOF on file 2-4 
. EOPEN 4-8 

error messages (CLI) 3-15 
external (.EXTN) declarations 

list of device/program names 2-3 

need for 2-2 
FILCOM 3-25 
file . 

attributes (. GTATR) 4-5 

closing (.CLOSE, .RESET) 4-10 

definition 2-1 

of utilities 3-2 

opening (.OPEN) 4-8 
filename table A -18 ff 
FORT 3-51 
FORTRAN IV 

command 3 -51 

configuring 5 -14 

.GCHAR 4-17 

. GCHN 1-2, 4-9 

. GDAY 4-20 

.GHRZ 4-22 

global subroutines A -27 

.ACHR A -31 

.CLS A -28 

.DISM A -33 

.IBUF A -31 

.IDCT A -34 

.LDB A -33 

.OBUF A -32 

.OPN A -30 

.RCHR A -30 

.RDLI A -30 

.ROSE A -29 

.STB A -32 

.SYSE A -34 

.WRLI A -29 

.WRSE A -28 
.GTATR 4-5 
GTOD 3-26 
. GTOD 4 -20 

HMA 1-6 

.IBUF routine A -31 
.IDCT routine A -33 
.IDEF 4-22 
LNIT 3-27 
interrupt 

considerations in adding device App. A 

handling A -22 

mask A -2 

search list A -14 

types of 1-3, 3-2 



INDEX-2 



INDEX ( Continued) 



I/O messages (CLI) 3-14 
.IRMV 4-23 

. LDB routine A -33 
level one devices A-l 
level two devices A-l 
LFE 3-45 
library file editor 

command 3-45 

configuring 5-6, 5-13 
library tapes 1-1 
line 

reading (. RDL) 4-10 

writing (,WRL) 4-15 
line printer 2-1, 4-28 
linkage A -5, A -7, A-24ff 
LOAD 3-28 

loaded program in core 1-5, 1-6 

loader (see relocatable loader or core image loader) 
loading library files 1-2, 2-2 
$LPT 2-1, 4-28 
LPTDR(.LPTD) 2-3 
LP132 2-3 

magnetic tape 

configuring utilities for 5-8 

files 2-4 

library 1 -1 

physical characteristics 2-4 

response to SOS 4-29 

tapes supplied for 5-1, 5-2, 5-4 

write permit ring 2-4 
master reel of utilities 5-8 
.MEM 4-18 
. MEMI 4-19 

memory available to user 1-5, 1-6 
MKABS 3-30 
MKSAVE 3-31 
MTA (magtape) 4-29 
MTADR (.MTAD) 2-3 
MTU1 -MTU -7 (. MTU1 -. MTU7) 2 -3 
MT0-MT7 2-1 

NMAX 

changing 4-19 
definific-r 1-6 

. OBUF routine A -32 
.OPEN 1-2, 4-8 
. OPN routine A -27 
.OPPP A -14, A -15 

paper tape 

configuring utilities for 5-6 
tapes supplied for 5-1, 5-2 



paper tape punch 2-1, 4-29 
paper tape reader 2-1, 4-29 
parameters (RDOS, SOS) App. C 
PARA.SR App. C 
PARU.SR App, C 
PARUA. SR App. C 
.PCHAR 4-17 
plotter 2-1, 4-26 
SPLT 2 -1, 4-26 
PLTDR 2-3 
PRINT 3-32 
SPTP 2-1, 4-29PTPD 
PTPDR 2-3 
SPTR 2-1, 4-28 
PTRDR (.PTRD) 2-3 
PUNCH 3-33 

R (ready) message 1-3, 3-7 

.RCHR routine A -30 

• RDL 4-10 

. RDLI routine A -30 

RDOS -compatible SOS 1-2 

RDOS to SOS interface 1-2 

.RDS 4-12 

RDSI 1-2 

.ROSE A -29 

.RDSI 1-2 

real time clock drivers 2-3 

RELEASE 3-34 

relocatable loader 

command 3-39 

configuring 5-6, 5-9 
repetitive argument storage 3-13 
.RESET 4-10 
R LDR 3-39 
.RQPEN 4-8 

RTCT1 - RTCT5 ( .RTC 1 - . RTC 5 ) 2-3 
RUBOUT 3 - 8 



save-restoxe program App. B 
SAVRE (. SAVR) 2 - 3 App. B 
SDAY 3-35 
.SDAY 4-2 1 
sequential 

read (. RDS) 4-12 

write (. WRS) 4-16 
SATRG 5-5 
SHIFT L 3-8 
SOS 

library 1-1, 2-3 

main program (SOS -MAIN) 



organization in core 
RDOS -compa tible 1 - 2 
(. SOS ) 1-2,2-3 
standard 1 -2 
system generation 1 -4 
user interface 1 -3 



2-3 
1 - 5 , 1-6 



Chapt , 



INDEX -3 



INDEX (Continued) 



stack frame A -25 
standard SOS 

definition 1 -2 

list of devices/channels 2-1 
.STB routine A -32 
STOD 3-36 
. STOD 4-20 
STTYDR {. STTY) 2-3 
switch 

alphabetic 3-12 

global 3-12 

indicator 3-8 

local 3-12 

numeric 3-11 
. SYSE routine A -34 
SYSG 3 -49, 5 -5 
SYSGEN 

command 3-49 

configuring 5-6, 5 -14 

used to produce trigger 5-5 

utility 2-2 
.SYSI 4-4 

system calls 1 -3 , Chapt, 4 
. SYSTM 4 -1 



utility program 

assembler 3-42, 5-7, 5-12 

command line interpreter 3-7 ff, 5-6, 5-10 

core image loader/writer 3 -4ff, 5 -6, 5-9 

definition 1-3 

FORTRAN IV 3-51, 5-14 < 

library file editor 3-45, 5-6, 5-13 

operation, general 3-1, 3-2 

relocatable loader 3-39, 5-1, 5-9 

SYSGEN 3 -49, 2 -2, 5 -5, 5 -6, 5-14 

text editor 3-41, 5-6, 5-11 

. WRL 4 -15 

.WRLI routine A -29 

.WRS 4-16 

.WRSE routine A -28 

XFER 3 -38 



tapes 1-1 

supplied to all 5-1 
supplied to cassette users 5 -2, 5 -3 
supplied to mag tape users 5-2, 5 -4 
supplied to paper tape u sers 5 -2 

teletypewriter 2-1 

TTI1 2-1,4-26 

$TTI 2-1,4-27 

TTOl 2-1,4-26 

STTO 2-1, 4-27 

$TTR 2-1, 4-28 
te-t editor 

command 3-41 

configuring 5-6, 5-11 
trigger 

definition 2-2 

producting a 2 -2, 5-5 
$TTI 2-1, 4-27 
TTI1 2-1, 4-26 
$TTO 2-1, 4-27 
TTOl 2-1, 4-26 
$TTP 2 -1, 4-26 
TTY' (.TTI1) 2-3 
TYPI 3 -37 

user, /application routines App. B 
user status table 4-30 
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